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FOREWORD 


The  Battlefield  Information  Systems  Technical  Area  of  the  Av:.y  Research 
Institute  Is  concerned  with  the  human  resource  demands  of  Increasingly  com¬ 
plex  battlefield  displays  used  to  acquire,  transmit,  process,  disseminate, 
and  utilize  information.  Current  research  focuses  on  human  performance  prob¬ 
lems  related  to  the  soldier  system  Interface  and  Is  concerned  with  such  areas 
as  software  development,  the  presentation  of  Information  on  complex  displays, 
user-oriented  systems,  decision  making,  systems  Integration,  and  utilization. 

Of  special  interest  are  human  factors  problems  related  to  developing  and 
validating  new  AOP  compatible  symbology  concepts  for  efficient  display  of 
tactically  significant  information.  In  a  three-task  symbology  contract  ef¬ 
fort  by  Perceptronics,  Inc.,  one  task  Involved  the  development  of  an  auto¬ 
mated  tactical  symbology  system  (TACSYM).  The  TACSYM  contains  over  700  sym¬ 
bols  from  various  military  symbol  sources.  A  user  of  TACSYM  can  index  symbols 
by  concept,  category,  or  source  and  have  these  graphically  displayed  on  a  CRT 
terminal.  The  current  document  describes  the  overall  architecture  of  the 
TACSYM  system-and  Its  general  operating  characteristics.  It  Is  Intended  as  a 
technical  guidebook  to  assist  those  who  will  be  deploying  TACSYM  on  an  exist¬ 
ing  computer  Installation. 


EDGAR  M.  JOHNSON 
Technical  Director 


AUTOMATED  TACTICAL  SYMBOLOGY  SYSTEM  (TACSYM):  SYSTEM  DESIGN  SPECIFICATIONS 


EXECUTIVE  SUMMARY 


Requirement: 

To  provide  detailed  documentation  of  the  automated  tactical  symbology 
system  (TACSYM)  architecture  and  operations.  TACSYM  was  developed  as  part 
one  of  a  three  task  contract  effort  to  Investigate  graphic  (symbolic)  por¬ 
trayal  of  battlefield  information.  The  catalog  exists  on  magnetic  tape  for 
use  on  UNIX-like  operating  systems  for  state-of-the-art  mainframe  computers. 


Procedure  and  Results: 

Outlined  in  this  system  specification  document  are  the  overall  and  de¬ 
tailed  system  design  of  the  TACSYM  catalog.  Following  this,  a  detailed  op¬ 
erational  description  is  provided.  Included  are  the  hardware  configurations 
for  the  original  system,  initial  Implementations  description  and  functional 
capabilities,  Interactive  features,  tutorial,  database  management,  and  file 
structure  organization  are  also  discussed.  The  final  discussion  provides  de¬ 
tailed  software  system  design  logic. 


Utilization: 

The  documentation  of  TACSYM  provides  an  understanding  of  the  structure, 
function,  and  operations  of  TACSYM  from  a  programmer's  perspective.  It  is 
intended  as  an  aid  to  implementation  of  the  software  in  future  installations. 
Also,  it  provides  the  basis  for  the  formation  of  guidelines  for  user  inter¬ 
actions  with  a  fielded  version  of  TACSYM. 
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1 .  INTRODUCTION 


1.1  Overview 

The  Automated  Tactical  Symbology  System  (TACSYM)  was  developed  to  catalogue, 
compare  and  evaluate  existing  and*proposed  military  symbologies  obtained  from 
many  sources.  Its  purpose  Is  to  produce  symbology  displays  and  hard  copies 
for  multiple  symbol  dimensions,  such  as  military  concept,  category,  symbol 
source,  alpha-numeric  Information  and  discrimlnablllty. 

The  primary  features  of  the  Automated  Tactical  Symbology  system  are: 

i 

0  Database  of  over  700  symbols  from  15  different  military  symbology 
sources. 

0  Interactive  access  allowing  users  to  graphically  display  and  print 
symbols  from  the  database. 

0  Symbol  building  capability  for  updating  database  and  experiment¬ 
ing  with  new  symbols. 

0  On-line  tutorial  explaining  capabilities  and  characteristics  of 
TACSYM. 

0  Query  mechanisms  allowing  users  to  locate  and  display  symbols  by 
specific  characteristics. 

1.2  System  Descrl pti on 

1.2.1  Hardware  Configuration.  TACSYM  can  use  either  the  Tekt’"on1x  4025"'  or 
4027  graphics  terminal.  These  types  of  terminals  have  high  resolution 
(640x482),  and  are  black  and  white  (4025)  or  color  (4027).  TACSYM  currently 
uses  only  the  black  and  white  capability  of  the  4027. 

Hhe  use  of  a  trademark  does  not  constitute  U.S.  Army  or  Department  of  De¬ 
fense  endorsement  of  the  product. 


The  hard  copy  device  Is  the  Tektronix  4631,  This  dry  Imaging  device  Is  con 
nected  directly  to  the  Tektronix  4025.  It  can  generate  standard  21.59  x 
27.94  cm  camera  ready  copies  of  the  Tektronix  screen.  Figure  1-2  Is  a  pic¬ 
ture  of  the  Tektronix  4631  . 
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I  Figure  1'-2  4031  Hard  Copy  Unit 

I 

TACSYM  was  implemented  on  a  POP  11/70  computer  system  which  uses  the  UNIX 
j  •  operating  system. 

J 

i 

J  1.2.2  Implementation  Description.  TACSYM  was  written  In  highly  structured 

I  modules  using  the  C  programming  language.  Structured  programming  provides 

■ 

;;  for  easy  understanding  and  results  In  better  programming  practice.  C  Is  a 

f 
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high  level  language  (HLL)  developed  at  Bell  Laboratories  originally  for  use 
in  inplementing  operating  systems,  compilers,  screen  editors,  syntactic  pars¬ 
ers,  and  other  utilities.  However,  in  the  past  several  years,  C  has  become 
a  popular  applications  language  as  well,  providing  computer  scientists  with 
an  exacting  control  of  data  structures,  file  I/O  string  manipulation,  and 
arithmetic  operations  not  found  in  other  HLL  such  as  FORTRAN  and  PASCAL.  In 
addition,  the  UNIX  users  group  has  advanced  the  state-of-the-art  in  porta¬ 
bility  of  prograinning  languages  and  operating  systems  (UNIX  is  written  al¬ 
most  entirely  in  C).  Existing  software  tools  permit  large  software  systems 
written  in  C  to  be  transported  easily  across  mcst  new  operating  systems  and 
new  CPU's. 

1.3  System  Capabilities 

1.3.1  Overview.  Figure  1-3  represents  a  full  system  component  view  of 
TACSYM.  The  TACSYM  illustration  consists  of  tutorial  and  catalogue  access 
components.  The  tutorial  is  an  on-line,  self  help  and  information  guide 
about  the  TACSYM  catalogue.  The  catalogue  component  contains  the  symbol 
database  and  access,  manipulation,  and  creation  capabilities,  The  tutorial 
and  catalogue  access  components  are  accessible  via  TACSYM's  initial  menu, 
and  are  easy  to  operate  and  understand. 

1.3.2  Tutorial .  The  tutorial  consists  of  areas  of  information  that  a  TACSYM 
user  can  explore  interactively  on  the  system.  The  tutorial  consists  of  a 
"System  Operations"  area  and  an  "Executive  Summary."  Embedded  self  documenta 
tion  such  as  on-line  tutorials  description  of  database  access  techniques, 
sample  sets  of  embellished  symbols  and  general  rules  for  symbol  construction 
are  all  contained  in  the  tutorial  section  of  TACSYM. 


TACSYM 


TUTORIAL 


CATALOGUi: 


CATALOGUE 


OVERVI 


SAMPLE 
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1.3.3  Catalogue  Access/Modification.  TACSYM  allows  symbols  and  primitives 


to  be  defined  as  a  collection  of  other  syii4)Ols,  primitives  or  graphical  ele¬ 
ments,  generated  via  keyboard  functions.  Symbols  are  stored  with  detailed 
Information  Including; 

0  Category  class  (aviation,  weapon,  communication,  etc.). 

0  Concept  name  (helicopter.  Infantry,  artillery,  etc.). 

0  Symbology  source(s)  (FM  21-30,  Combat  Power  Symbology, 

NATO  D-49,  etc.). 

0  Remarks  (user  Information  pertaining  to  the  symbol). 

0  Discrimlnablllty  Index  for  symbol  comparison. 

Categories,  concepts  and  sources  can  be  Individually  Inserted  provided  they 

are  non-existent  In  the  database  or  deleted  provided  they  are  not  represented 


in  any  existing  symbol.  TACSYM  allows  for  the  ►'emoval  of  symbols  and  primi¬ 
tives  by  name  only.  The  database  can  be  searched  on  a  number  of  different 
selection  criteria  cuch  as: 


0  Direct  access  of  primitives,  by  a  number  associated  with  a 
name  in  the  primitive  list. 

0  Direct  access  of  symbols  by  number. 

0  Simple  enumerativc  display  of  all  primitives. 

0  Simple  enumerative  display  of  all  symbols. 

0  Simple  enumerative  display  of  all  flagged  symbols. 

0  Display  of  all  symbols  for  a  selected  source,  e.g.,  FM  21-30. 

0  Display  all  symbols  for  a  selected  concept. 

0  Display  all  symbols  for  a  selected  category  class. 


TACSYM  also  provides  the  following  modes  of  hard  copy  printing; 


0  Direct  user  copy  of  screen  content. 

0  Automatic  copy  of  all  symbols  in  the  database. 


Figure  1-4  illustrates  catalogue  access/modification. 


1 . 4  System  Characteristics 

The  catalogue  “categories"  of  TACSYM  are  military  classifications  which  com' 
prise  a  particular  group  of  symbols.  The  symbols  which  are  assigned  to  a 
category  have  sonre  physical  meaning  in  common  with  one  another.  The  first 
two  digits  of  a  symbol  number  indicate  its  category. 


Symbol  Categories 


1.  Activity 

2.  Aviation 

3.  Communication 

4.  Vehicles 

5.  Tactical  Unit 

6.  Measle 

7.  Combat  Service  Support 

8.  Nuclear  Bio  Chem 

9.  Obstacles  and  Fort 

10.  Installations 

11.  Weapon 


Symbols  I PriRdthres  I  I Flaggod  SyRd»ols|  I  Symbol  1 1 Cmicopt it  Sourcs  1 1 Category 


Pick  From 


The  catalogue  "sources"  of  TACSYM  are  names  Identifying  groups  of  symbols 
which  refer  to  a  military  symbology.  The  symbols  of  a  particular  source  are 
common  by  the  fact  that  they  were  designed  to  satisfy  the  requirements  for 
communicating  military  Information  In  some  fashion. 


Symbology  Sources 


1.  Divras 

2.  NATO  0-49  (1980) 

3.  TOO 

4.  FM  21-30 

5.  TOS 

?!  BETA  Test  Bed 

8.  MI  PASS 

9.  TA0C-8S 

10.  TACC 

11,  ITAOC 

12..  AF  E-3A  PPI 

13.  AF  407L/4B5  LT 

14.  PLRS 

15.  AFR  SS-2S 

16.  FM  101-5-1 

17.  core- VI DS 


The  Catalogue  Concepts  of  TACSYM  are  military  descriptions  about  the  sym¬ 
bology.  These  concepts  further  describe  a  symbology  In  relation  to  Its 
graphics  Image  and  category  (l.e..  the  concept  fighter  Is  used  to  describe 
an  Iconic  of  a  plane  contained  In  the  Aviation  category). 
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Symbol  Concepts 

1 .  Action 

2.  Bridging 

3.  Ferrying 

4.  Movement 

5.  Destroyed 

6.  Phoney 

7.  Propaganda 

8.  Responsibility 

9.  Snorkel Ing 

10.  Aerial 

11.  Antisubmarine 

12.  Aviation 

13.  Bomber 

14.  Close  Air  Support 

15.  Drone  Aircraft 

16.  Fighter 

17.  Fixed  Wing  Aircraft 

18.  Helicopter 

19.  Marine 

20.  High  Performance 

21 .  Medevac 

22.  Rescue 

23.  Seaplane 

24.  Transport 

25.  Emit 

26.  Message  Center 

27.  Signal 

28.  Nuclear 

29.  Formation 

30.  Reconnaissance 

31.  Jamming 

32.  Radar 

33.  Radio 

34.  Telephone 

35.  Teleprinter 

36.  Television 

37.  ADP  Central 

38.  Elec.  Navig.  Aid 

39.  Microphones 

40.  Target  Designator 

41.  Visual  Station 

42.  Amphibious 

43.  Animal 

44 .  Armoured 

45.  Boat 

46.  C-Cube 

47.  Cargo 

48.  Engine 

49 .  Ferry 

50.  Air  Cavalry 


Symbol  Concepts 

51 .  Hovercraft 

52.  Operational 

53.  Communication 

54.  Over-snoM 

55.  Personnel 

56.  Missile 

57.  Railway 

58.  Shooter 

59.  Sledge/sled 

60.  Vehicle 

61.  Ship 

62.  Airfield 

63.  Submarine 

64.  Tracked 

65.  Landing  Site 

66.  Train 

67.  Wheeled 

68.  Unspecified 

69.  Landing  Zone 

70.  Vehicles 

71 .  Surface 

72.  Seaplane  Station 

73.  Landing  Vehicle 

74.  MICV 

75.  A1r  Defense 

76.  Anihunitlon 

77.  Air  Mobile 

78.  Air  Transportable 

79.  Air  Naval  Ground 

80.  Airborne 

81.  Antiaircraft 

82.  Antitank 

83 .  Armour 

84.  Army  Security  Agcy 

85.  Artillery 

86.  Collecting  Point 

87 .  FA 

88.  Construction 

89 .  CBR 

90 .  Chemi  cal 

91 .  Combined  Arms  Army 

92.  CEWI 

93.  C2  Element 

94.  Decontamination 

95 .  Command 

96.  Electronic 

97.  Electronic  Warfare 

98.  Engineer 

99 .  Food 

100.  Infantry 


Symbol  Concepts 

101.  Fuel 

102.  Irregular  Forces 

103.  Maneuver  Unit 

104.  Marines 

105.  Brigade 

106.  Military 

107.  Mortar  Fire  Unit 

108.  Motor  Rifle 

109.  Mountain 
no.  Movers 

111.  Navy 

112.  Ordnance 

113.  Parachute 

114.  Reinforcement 

115.  Shooters 

116.  Special  Forces 

117.  Bio  or  Chem  Event 

118.  Contamination 

119.  Radioactive  Area 

120.  Radioactive 

121.  Targets 

122.  Booby  Trap 

123.  Bridge 

124.  Demolition 

125.  Fence 

126.  Data  Proc.  Unit 

127.  Dental 

128.  Maintenance 

129.  Major  End  Items 

130.  Medical 

131.  Hospital 

132.  Medical  Supply 

133.  Mines 

134.  Missile  Supply 

135.  Multi -Cl  ass 

136.  Multi  role 

137.  Nuclear  Storage 

138.  Personal  Demand 

139.  Repair  Parts 

140.  Wire 

141.  Obstacle 

142.  Subsistence 

143.  Traffic  Control 

144.  Unknown  Logistic 

145.  Water 

146.  Force 

147.  Headquarters 

148.  Landing 

149.  Logistics  Unit 

150.  Marine  Amphibious 


Symbol  Concepts 


Symbol  Concepts 

Symbol  Concepts 

Symbo 

1  Concepts 

151.  Aero  Medical 

161. 

Tank 

171. 

Weapon 

152.  Motor  Transport 

162. 

Clothing 

172. 

Smoke  Generator 

153.  Petroleum  Supply 

163. 

Plane 

173. 

Tracks 

154.  Shore  Party  Team 

164. 

Flame  Thrower 

174. 

Vegetation 

155.  Support 

165. 

Gun 

175. 

Toxic  Agent 

156.  Rear  Area  Operations 

166. 

Mortar 

176. 

Trenches 

157.  Service 

167. 

Naval  Gunfire 

177. 

Zone 

158.  Trains 

168. 

Rifle 

178. 

Commo  Site 

159.  Ground  Attack 

169. 

Rocket 

179. 

Howitzer 

160.  ICV 

170. 

Rocket  Launcher 

2.  OVERALL  DESIGN 


2.1  System  Organization 

Figure  2-1  represents  the  logical  structure  of  TACSYM.  TACSYM  consists  of 
two  components:  Tutorial  and  Query.  During  execution,  each  component  runs 
with  dependency  on  the  database  an-'  the  software  support  system.  The  Intro¬ 
duction  processor,  via  user  command,  determines  which  direction  to  take  In 
TACSYM.  Figure  2-2  Is  a  table  of  source  files  that  are  compiled  and  linked 
Into  executable  modules  for  Tutorial  and  Query.  The  detailed  description 
of  these  source  files  appears  In  Section  3-1,  overview  of  software  modules. 


2.1.1  Introduction  Processor  Component.  The  Introduction  processor  component 
generates  the  first  page  of  the  TACSYM  catalogue.  It  provides  three  alterna¬ 
tives  to  the  user.  One  Is  to  examine  the  tutorial  describing  the  catalogue 
and  Its  operations.  Two  Involves  the-top  menu  of  the  catalogue  access  and 
modification  section.  Three  terminates  TACSYM  and  erases  the  screen.  The 
system  file  INTROl.C  contains  the  main  entry  point  for  TACSYM.  This  file  con¬ 
trols  the  execution  of  the  Tutorial  and  Query  components  of  the  system.  It 
also  controls  the  termination  process  of  TACSYM.  The  tutorial  Is  executed  by 
a  procedure  call.  The  query  component  Is  accessed  by  the  UNIX  "exec!"  com¬ 
mand.  Since  the  query  component  Is  a  separate  program  (DATABASE),  the  "exec!" 
command  Is  used  to  call  It.  Upon  exit  from  the  main  procedure  of  the  query 
component,  TACSYM  Is  called  again  via  the  "execl"  command.  TACSYM  and 
DATABASE,  although  containing  many  of  the  same  routines,  are  two  separate 
executable  programs  each  smaller  than  the  64K  byte  maximum  process  size  for 
most  PDP  11  's. 
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Tutorial  Source  Files 


arcl.c 
arcS.c 
graphic. c 
Introl.c 
intro2.c 
introduction.c 
rawcook  .c 
atr.c 
takl.c 
trig.c 


Query  Source  Files 

arcl.c 
arcZ.c 
database. c 
graphic. c 
rawcook.c 
scan.c 
str.c 
tekl.c 
trig.c 


The  source  files  contain  the  routines  needed  to  operate  and  process  TACSYM 
The  source  files  contain  detailed  Information  which  Includes! 


0  VARIABLE  DEFINITIONS  (GLOBAL  AND  LOCAL) 

0  PARAMETER  Definitions 
0  Detailed  explanations  of  the  ROUTINE  LOGIC 
0  Detailed  explanations  of  the  SOURCE  CODE 


2.1.2  Tutorial  Processor  Component.  The  tutorial  processor  component  Is  a 


system  teaching  mechanism.  It  allows  users  to  learn  all  tM  capabilities  of 
the  system.  By  paging  through  the  tutorial,  users  can  ir'ead  about  and  prac¬ 
tice  the  functions  of  the  system.  They  can  also  learn  about  the  meanings  of 
symbols,  how  symbols  are  composed,  how  the  catalogue  access  mechanism  works 
as  well  as  the  history  of  the  TACSYM  project. 

The  file  INTRODUCTION.C  Is  a  command  file  processor  with  special  characteris¬ 
tics.  It  processes  text  files  which  contain  embedded  commands.  The  commands 
range  from  controlling  text  pages  to  Identifying  optional  branching  sequences 
In  the  tutorial  hierarchy  to  generating  graphics  on  the  Tektronix.  In  order 
to  generate  graphics,  the  graphics  related  files  GRAPHIC. C,  ARCl.C,  ARC2.C, 
TEKl.C  are  linked  together  with  INTRODUCTION.C.  In  order  to  perform  the  query 
program  functions  In  INTR02.C^  It  Is  linked  to  INTRODUCTION.C. 

2.1.3  Query  Processor  Component.  The  query  processor  component  1s  the  pro¬ 
gram  which  accesses  and  modifies  the  database.  The  system  file  DATABASE. C 
contains  the  main  entry  point  for  the  query  processor.  The  menu  driven  ac¬ 
cess  to  the  database  Is  controlled  by  DATABASE. C  and  SCAN.C  respectively. 
SCAN.C  contains  procedures  used  to  scan  Information  In  the  database. 

DATABASE. C  also  contains  procedures  which  allow  for  modification  of  the 
database.  Insertion  and  removal  of  data  from  the  database  Is  controlled  by 
DATABASE. C. 

2.1.4  Software  Support  System.  The  software  support  system  used  by  TACSYM 
consists  of  the  system  files  ARCl.C,  ARC2.C,  GRAPHIC. C,  RAWCOOK.C,  STR.C, 


TEKl.C,  and  TRIG.C.  The  software  support  system  1s  used  by  the  Introduction 
processor,  tutorial  component  and  query  component.  The  software  support  sys¬ 
tem  wa:  oei 1 jc  tJul  any  component  of  TACSYM  could  use  Its  highly  struc¬ 
tured  and  diversified  routines.  String  manipulation,  structured  I/O,  and  low 
level  data  manipulation  routines  are  used  to  Interface  TACSYM  with  the  Tek¬ 
tronix  4025  graphics  terminal  and  database  file  I/O.  The  graphic  procedures 
used  by  the  query  and  database  components  are  complex  mathematical  routines 
used  throughout  TACSYM  In  generating  symbols,  primitives  and  graphical  ele¬ 
ments.  The  routines  of  the  software  support  system  utilize  the  capabilities 
of  the  operating  system,  the  C  programming  language,  and  the  Tektronix  4025 
graphic  terminal. 

2,1,5  User  Interface.  The  user  Interface  Interprets  and  responds  to  user 
entered  commands.  The  12  function  keys  of  the  Tektronix  4025  have  been  pro¬ 
grammed  to  perform  various  functions,  Other  keys  on  the  keyboard  have  been 
programmed  as  well  for  specific  operations.  Figure  2-3  Is  a  layout  of  the 
TACSYM  keyboard.  Table  2-2  lists  the  use  of  the  function  keys.  TACSYM  al¬ 
ways  lets  users  know  the  keyboard  options  they  have  throughout  Its  operation. 
Keyboard  overlays  are  provided  for  use  with  TACSYM. 

2 . 2  Database  Orqanizatl on 

The  TACSYM  database  utilizes  the  hierarchical  file  system  structure  provided 
by  the  UNIX  operating  system.  The  file  system  Is  tree  structured  permitting 
construction  of  directories  of  sub-trees.  This  type  of  file  system  organi¬ 
zation  permits  a  well  structured  database. 
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KEYBOARD 


SI: 

FI: 

S2: 

F2: 

S3: 

F3: 

S4: 

F4: 

S5: 

F5: 

S6: 

F6: 


S7: 


F7: 


Moves  graphics  cursor  5  positions  to  the  left. 

Moves  graphics  cursor  1  position  to  the  left. 

Moves  graphics  cursor  5  positions  up. 

Moves  graphics  cursor  1  position  up. 

Moves  graphics  cursor  5  positions  down. 

« 

Moves  graphics  cursor  1  position  down. 

Moves  graphics  cursor  5  positions  to  the  right. 

Moves  graphics  cursor  1  position  to  the  right. 

Defines  a  point  to  be  used  In  creating  primitives  of  sym¬ 
bols,  places  an  X  at  the  defined  point. 

Same  function  as  S5. 

Erases  all  defined  points  and  positions  the  cursor  at  the 
first  point  It  originally  defined. 

Connects  any  points  currently  defined  by  vectors.  Maximum 
of  five  vectors  will  be  drawn  since  six  (6)  points  1s  the 
maximum  allowed  to  be  defined,  at  one  time. 

Fills  an  arc  defined  by  last  three  points  defined.  The  base 
of  the  arc  is  defined  by  the  first  and  third  points. 

Draws  an  arc  defined  by  last  three  points  defined.  The 
ends  consist  of  the  first  and  third  points  defined. 


Table  2-2  Function  Key  Description 


a 

I 

'.'i* 


5s; 
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Draws  a  filled  circle  which  1s  defined  by  last  two  points 
defined  given  any  rotation. 

Draws  a  circle  which  is  defined  by  last  two  points  defined 
given  any  rotation. 

Pills  a  polygon,  which  can  have  at  most  six  sides  but  no 

Is  allowed  to  be  intersected  by  other  sides.  Maximum  of  six 
points  can  be  used  to  define  the  polygon  with  the  last  point 
defined  automatically  connected  to  che  first  point  defined. 

A  minimum  of  three  points  Is  required. 

Draws  a  polygon,  which  can  have  at  most  six  sides.  Maximum 
of  six  points  can  be  used  to  define  the  poygon,  with  the 
last  point  defined  automatically  connected  to  the  first 

defined.  A  minimum  of  three  points  Is  required. 

Add  symbol  asks  for  a  symbol  number  and  inserts  that  s^bol 
relative  to  where  the  cursor  is  currently  at. 

Add  primitive  asks  for  a  primitive  name  and  Inserts  that 
primitive  relative  to.  where  the  cursor  is  currently  at. 

Add  text  allows  the  Insertion  of  any  keyboard  text.  It  is 
terminated  by  pressing  any  function  key  or  when  there  Is  no 
room  on  the  right  or  bottom  side  of  the  graphics  window. 

When  there  Is  no  room  on  the  right  side,  the  cursor  Is 
positioned  on  the  next  line,  In  line  where  text  insertion 
started  on  the  previous  line.  In  the  case  where  no  room  Is 
left  on  the  bottom  Hne  the  cursor  is  positioned  at  the  top 
line.  In  line  where  text  insertion  started  on -the  bottom 
line. 


Table  2-2  Continued 


Fll; 

S12: 

F12; 

EXIT; 

CONFIRM: 

some 

BACKSPACE: 

PREVIOUS  PAGE: 
generated. 


Erases  last  addition  clears  and  redraws  all  work  performed 
In  the  graphics  window  except  for  last  Item  Inserted. 

Grid  toggle  Is  a  toggle  switch  which  toggles  on  and  off  grid 
liner  and  the  boundry  coordinates  of  the  graphics  window. 

Redraw  clears  and  redraws  everything  in  the  graphcls  window. 

Used  to  back  out  one  level  of  the  program  upon  each  press. 

Used  In  completing  an  Input  string,  paging  forward,  or  In 

cases  exiting.  Treated  as  a  carriage  return. 

When  typing  text  used  to  backspace. 

In  tutorial  the  previous  page  In  a  sequence  will  be 


REPEAT:  In  tutorial  the  current  page  will  be  generated  again. 

PRINT:  If  the  hard  copy  device  Is  on  and  connected,  a  hard  copy  of 

the  current  page  of  the  Tektronix's  will  be  generated. 


Table  2*2  Continued 


2.2J  Data  Base  Management  System.  The  DBMS  combines  features  of  the  UNIX 
operating  system  and  file  I/O  processing  capabilities  of  the  C  programming 
language.  TACSYM  utilized  the  functlonablllty  of  C  and  UNIX  In  operations 
such  as  sorting,  file  I/O,  updates,  deletions  and  other  database  maintenance 
operations.  The  concepts  of  data  integrity,  data  access  and  limited  redun¬ 
dancy  are  manifest  In  TACSYM.  The  DBMS  for  TACSYM  Is  classified  as  a  self- 
contained  system  Indicating  that  queries  on  the  database  are  fixed  or  prede¬ 
fined.  The  attractiveness  of  TACSYM  Is  embedded  self-documentation  and 
helpful  menu  commands  which  make  It  easy  to  use.  The  menus  permit  easy  data 
manipulation. 


2.2.2  Database.  Figure  2-4  Illustrates  the  TACSYM  DATABASE  Implementation 


under  UNIX.  The  Control  Directory  contains  the  following  TACSYM  Control 
Files  - 


0  TACSYM 
0  Symbol 

■  0  Flagged  Syntol 
0  Source 
0  Concept 
0  Category 
0  Primitive 


Executable  load  module 

List  of  symbol  numbers  In  the  database 

List  of  flagged  symbol  nuirbers  In  the  database 

List  of  symbology  source  names 

List  of  symbology  concept  names 

List  of  symbology  category  names 

List  of  unique  primitive  names  used  to  construct 

symbol s 


and  the  following  sub- directories  — 


0  Symbols  -  Contains  a  pair  of  files  for  every  symbol  Inserted 
Into  the  database.  The  n.n.n  file  of  a  symbol  con¬ 
tains  that  symbol's  graphical  description  and  the 
Tn.n.n.  file  contains  a  symbols  text  description. 
The  range  of  n.n.n  Is  0.0.0.  to  99.999.999,  allow¬ 
ing  the  database  to  contain  10  million  symbols  (If 
any  file  system  could  support  that  many). 
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0  Sources 


0  Concepts 


0  Categories 


0  Primitives 


0  Tutorial 


Contains  files  for  each  symbology  source  In  the 
database.  Each  source  file  contains  the  list  of 
syntol  numbers  In  that  source. 

Contains  files  for  each  symbology  concept  In  the 
database  and  each  file  contains  a  list  of  symbol 
numbers  representing  the  concept. 

Contains  files  for  each  s^'mbology  category  (number 
of  categories  Is  small  >•  approx.  11).  Each  cate¬ 
gory  file  contains  a  list  of  symbol  numbers  In  the 
category. 

Contains  files  of  primitive  basic  shapes  and  widely 
used  symbol  parts.  When  constructing  symbols  the 
primitives  can  be  accessed  by  name  and  used  as 
building  blocks.  Each  file  contains  graphical  de¬ 
scriptors  necessary  to  construct  the  shape. 

Contains  files  of  text  and  graphical  descriptions. 
These  files  are  opened  and  processed  by  the  file 
processor  program  used  during  the  tutorial  part  of 
TACSYM. 


2.3  File  Structures 
2.3.1  Catalogue  Database. 

Category  Control  File 

The  category  control  file  Is  of  variable  length  and  each  record  can  contain 
no  more  than  twenty  ASCII  characters.  A  newline  character  Is  appended  at  the 
end  of  each  record. 


record  1 

Tactical  Un1t\n 

record  2 

• 

• 

Av1at1on\n 

« 

• 

• 

record  N 

Weapon\n 
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Concept  Control  File 

The  concept  control  file  Is  of  variable  length  and  each  record  can  contain  no 
more  than  twenty  ASCII  characters.  A  newline  character  Is  appended  at  the 
end  of  each  record. 


record  1 
record  2 
« 

« 

record  n 


Source  Control  File 

The  source  control  file  Is  of  variable  length  and  each  record  can  contain  no 
more  than  fifteen  ASCII  characters.  A  newline  character  Is  appended  at  the 
end  of  each  record, 


record  1 
record  2 
• 

record  n 


Primitive  Control  File 

The  primitive  control  file  Is  of  variable  length  and  each  record  can  contain 
no  more  than  fifteen  ASCII  characters.  A  newUno  character  1s  appended  at 
the  end  of  each  record. 


0IVRAS\n 

NATO  0-49  (1980)\n 


TAOC  1  45\n 


Act1on\n 

Br1dg1ng\n 


e 

Jatnm1ng\n 


pucord  I 
rocord  Z 

•i 

• 

ft 

ft 

record  n 


Symbol  Control  File 

The  symbol  control  file  is  of  variable  length  and  each  record  contains  ten 
ASCII  characters.  A  newline  character  Is  appended  at  the  end  of  each  record. 


record  1 
record  2 

a 

ft 

ft 

ft 

ft 

record  n 


Flagged  Symbol  Control  File 

The  flagged  symbol  control  file  Is  of  variable  length  and  each  record  contains 
ten  ASCII  characters.  A  newline  character  Is  appended  at  the  end  of  each 
record. 


OOlOOl.uOisn 

0010Ql.Q02\n 


011001. OOl\n 


Zw1ng\n 

VMA\n 


ft 

med  H\n 


record  1 
record  Z 


record  n 


001002. 002Nn 
005003. 001\n 


009002. 00  l\n 


V 


Source  Sub- Directory 

The  source  sub-directory  contains  files  corresponding  to  each  source.  Those 
files  contain  records  of  ASCII  characters  with  a  newline  character  appended 
to  each  record  and  are  variable  length  files. 


File 


Source  Sub-01  rectory 


001002. 001\n  . 
003003. 005\n 


003002. 00l\n 
004004. on  l\n 


Prlml t1 ve  Sub -PI  rectory 

The  primitive  sub-directory  contains  £11es  corresponding  to  each  primitive. 
These  files  are  variable  length  and  have  variable  length  records. 


Primitive  Sub-01  rectory 


V  XI  Y1  X2  Y2  n 
A  XI  Y1  X2  Y2  X3  Y3  n 


The  file  contents  are  explained  further  In  section  2.4. 
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Symbol  Sub-Directory 

The  symbol  sub-directory  contains  files  corresponding  to  each  symbol  and  to 


the  symbols  text  information.  These  files  are  variable  length  and  have 
variable  length  records. 


f  Piles 

ooloor.ool  --> 


V  XI  Y1  X2  n  n 


Symbol  Sub-Directory  ——————  TOlOOl.OOl 


N;  1.1 

K;  TACTICAL  UNIT 


The  file  contents  are  explained  further  In  section  2.4. 


Tutorial  Sub-D1 rectors 


The  tutorial  sub-directory  contains  files  corresponding  to  symbols,  primi¬ 


tives,  text  and  menus  that  are  used  In  the  tutorial  section  of  TACSYM. 


Tutorial  Sub-Directory  - 


Files 

40117^ . > 


V  XI  Y1  X2  Y2  n 


Genrul 


MOR 

GENERAL 


The  file  contents  are  explained  further  In  section  2.4, 


2.4  Data  Structure  Definition 


In  section  2.3,1  the  primitive,  symbol  and  tutorial  sub-directory  files  were 
introduced.  They  are  explained  further  here.  Figure  2-5  is  a  conceptual 
view  of  how  the  graphic  elements,  primitives  and  symbols  make  up  a  symbol 
representation. 


Graohi c  Elements 

Graphical  elements  consist  of  vectors,  arcs,  filled  arcs,  circles,  filled 
circles,  polygons,  filled  polygons  and  text.  These  elements  can  be  "owned" 
by  symbols  or  primitives.  They  are  represented  in  the  files  as  follows; 


Description  Identifier 


Defined 


Vectors 

Arcs 

Filled  Arcs 
Circle 

Filled  Circle 
Polygon 

Filled  Polygon 
Text  String 


•v' 

a' 

'b' 

'c' 

•d' 

'fl' 

'h' 

'f 


up  to  6  pairs  of  x,y  coordinates 
2  pairs  of  x,y,  coordinates 

H  )• 


M  I) 

II  II 

3-6  pairs  of  x,y,  coordinates 

II  ,  II 

I  pair  of  x,y  coordinates  followed 
by  a  text  string 


Primitives 

Primitives  can  be  composed  of  (1)  syntols,  (2)  other  primitives,  (3)  graphical 
elements,  and  (4)  any  combination  of  1 ,  2,  and  3.  Primitives  are  Identified 
by  a  unique  file  name.  When  contained  in  other  symbols  or  primitives  they 
are  identified  as; 

•P'  NAME  b  XI  b  Yl\n 
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Symbols  can  be  composed  of  (1)  other  symbols,  (2)  primitives,  (3)  graphical 
elements,  and  (4)  any  combination  of  1 ,  2,  and  3.  Symbols  are  Identified  by 
a  unique  file  name,  with  the  format  of  n.n.n.  When  contained  In  other  sym¬ 
bols  or  primitives  they  are  Identified  as: 


'S'  It  nnnnnn.nnnb  XI  It  Yl\n 


For  every  symbol  1n  the  database  there  are  two  files  defining  It: 


nnnnnn.nnn  -  contains  the  graphic  elements  defining  the  symbol, 
tnnnnn.nnn  -  contains  the  text  and  control  Information  pertaining 
to  the  symbol . 


The  text  file  contains  the  text  Information  about  the  symbol.  As  the  text 
Is  keyed  In  when  creating  the  symbol, Jt  Is  written  to  this  file,  A  tixt 
file  consists  of  the  symbol  number,  category,  primary  concept,  secondary 
concept,  sources,  remarks  and  a  flag  Indicator.  The  format  for  a  text  file 


N  :  n.n.nvn 

■R'  :  CATEGORY/ sn 

7  :  PRIMARY  C0NCEPT/\n 

Tst  LINE  of  SECONDARY  C0NCEPT\n 

2nd  LINE  of  SECONDARY  C0NCEPl\n 

S  :  1st  LINE  of  SOURCESNi 

7nd  LINE  of  SOURCESVi 

R  :  Ist  LINE  of  REMARKSSn 

7nd  LINE  of  REMARKS\n 

F  :  FLAG  (y  or  n) 


The  length  of  this  file  1s  variable  and  each  record's  length  except  for  the 
flag  Indicator  record  Is  variable.  The  name  of  the  text  file  1s  determined 


by  a  T  substituted  for  the  first  digit  of  the  symbol's  file  name  (I.e., 
symbol  007008.001  text  file  would  be  T07008.001). 

Tutorial  Text  Files 

The  tutorial  text  files  are  composed  of  text  with  special  commands  preceded 
by  a  slash.  These  commands  communicate  to  the  program  such  things  as  draw 
any  graphical  element  at  a  specific  location  on  the  mon1tor»  erase  the  moni¬ 
tor,  wait  for  a  user  reply,  generate  a  symbol  at  some  location  and  many  other 
functions.  These  commands  are  defined  and  listed  In  section  3.2. 


if  \ 

y,',' 


t 


3.  DETAILED  SYSTEM  DESIGN  (SOFTWARE) 


Overview  of  Software  Modules 

The  software  logical  components  of  TACSYM  include  the  Introduction  processor, 
Tutorial  processor,  Query  processor  and  the  Software  Support  System.  The 
system  files  which  comprise  these  modules  are  listed  and  briefly  described  in 
Table  3-1.  The  files  are  designed  so  they  can  be  used  across  different  mod¬ 
ules.  Table  3-2  groups  the  files  required  by  system  function.  The  remaining 
sections  in  this  chapter  provide  a  detailed  synopsis  and  description  of  all 
the  software  procedures  in  TACSYM. 

3*2  Introduction  Processor  Component 
introl.c 

NAME 

MAIN  -  Main  procedure  for  TACSYM "program. 

SYNOPSIS 
MAIN  0 

DESCRIPTION 

Main,  generates  the  initial  page  of  the  TACSYM  catalogue  and  controls 
the  system  options  available  to  the  user. 


arcl.c  -  An  extension  of  graphic. c,  arcl.c  contains  the  sub¬ 

routine  arc  used  1n  computing  and  displaying  arcs  or 
filled  arcs. 

arc2.c  -  An  extension  of  arc1.c«  arc2.c  contains  the  subroutine 

recur  called  by  the  arc  subroutine.  Recur  1s  called 
repeatedly  until  criteria  about  the  arc  being  computed 
are  met. 

databare.c  -  Controls  database  access  and  manipulation  of  symbols. 

direct. h  -  Header  file  containing  defined  constants  used  by  more  than 

1  file. 

graphic. c  -  Contains  the  subroutines  used  In  generating  symbols, 

primitives  and  graphical  elements. 

Introl.c  -  Controls  execution  of  TACSYM's  tutorial  and  database 

access  components. 

1ntro2,c  -  An  extension  of  Introductlon.c  used  In  linking  to  database 

routines  which  are  used  In  the  tutorial. 

introductlon.c  -  Controls  the  tutorial  mechanism  of  processing  text  flltn 
with  embedded  commands. 

rawcook.c  -  Sets  terminal  to  echo  keyboard  Input  on  the  monitor  or 

turns  echo  capability  off. 

scan.c  -  An  extension  of  database. c,  scan.c  controls  all  scanning 

procedures. 

str.c  •  File  I/O  subroutines  used  In  supporting  data  manipulation 

from  the  terminal  and  the  database  files. 

tekl.c  -  Subroutines  used  In  communicating  between  the  Tektronix 

graphics  system  nnd  the  software  components. 

trig.c  -  Trigonometric  subroutines  used  1n  supporting  graphical 

calculations. 


TABLE  3-1 


^ ^  Processor  Component 
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NAME 

TUTOR  -  Main  controller  routine  for  the  command  file  processor 
used  In  TACSYM's  tutorial. 

SYNOPSIS 

TUTOR  0 

DESCRIPTION 

Tutor  Is  the  main  driver  for  the  tutorial  component  of  tacsym. 
Initially  it  sets  up  the  tektronix  screen  and  generates  all  the  menus 
that  will  be  needed  In  the  tutorial.  It  loads  the  main  text  file 

"TEXTPILE  Into  the  options  structure.  It  calls  LEARNl  which  defines 
the  namefunctlon  keys  that  will  be  needed  In  the  tutorial.  The 
procedure  SETUP  Is  called  within  a  loop.  The  returned  value  from  SETUP 
controls  the  program. 


NAME 

SETUP  -  Main  file  I/O  routine 

SYNOPSIS 

SETUP  (K) 

K  -  Indlce  of  the  options  structure,  which  contains  a  text  fUn 
to 

open  and  process. 

DESCRIPTION 

SETUP,  opens  the  file  whose  name  is  stored  In  the  options  structure. 
It  processes  the  file  a  character  at  a  time.  All  file  commands  are 
preceded  by  a  backslash  \  .  The  routine  CHECK  Is  executed  when  a 
command  Is  encountered.  If  the  option  flag  Is  1,  LOAD  Is  executed  to 
process  the  user  controlled  option's  list.  SETUP  returns  the  Index  of 
the  options  structure  which  contains  the  next  file  to  process.  If  -1 
Is  returned  then  the  program  Is  terminated. 
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NAME 

LOAD  -  Controls  th«  options  m«nu  which  Is  usar  salactabla. 

SYNOPSIS 

LOAD  (K) 

K  -  Indax  of  option  structura  whara  naw  file  will  ba  addad  (K+ll 
or  axl sting  ona  dalatad  (K-l). 


DESCRIPTION 

LOAD*  scans  tha  option  list  which  was  ganaratad  In  SETUP.  Scanning  Is 
dona  by  highlighting  tha  tnanu  Itams.  Whan  confirm  Is  prassad,  tha 
Information  for  tha  option  salactad  Is  movad  Into  tha  K+1  spaca  In  tha 
options  structura.  If  axit  Is  prassad  k-l  Is  raturnad. 


NAME 

CHECK  -  Procassas  a  command  In  a  flla. 

SYNOPSIS 

CHECK  (1) 

1  -  Currant  Indax  of  options  structura  whara  tha  currant  flla 
to  ba  procass  rasidas. 


DESCRIPTION 

CHECK  raads  1n  a  command,  valldatas  It,  sats  tha  appropriata  flags, 
reads  In  any  Information  that  might  ba  contalnad  on  tha  command  line 
and  via  a  switch  statemant  procassas  tha  command. 
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NAME 


SW  -  Controls  cursor  movement  1n  the  graphic  area  during  the  tutorial. 


SYNOPSIS 
SW  (a) 

a  -  Integer  value  corresponding  to  one  of  8  cursor  movement  options. 


DESCRIPTION 

SW,  controls  the  cursor  movement  In  the  graphics 
torlal  on  the  function  keys. 


window  during  the  tu- 


NAME 

MORE  -  Controls  paging  mechanism. 

SYNOPSIS 

^ch*-  Integer  character  to  Indicate  which  paging  option  to 

perform.  , 

1  -  Index  of  current  file  being  processed  In  option  structure. 


DESCRIPTION 

MORE,  controls  the  paging  mechanism's  of  generating  a  previous  page, 
repeating  the  current  page  or  going  to  the  next  page. 


NAME 

DONE  -  Displays  blank  menu 


for  the  "more"  command. 


SYNOPSIS 
DONE  0 


DESCRIPTION  ,  , 

DONE,  displays  the  blank  menu  and  sets  the  exit  flag  to  1.  It  s  used 
In  conjunction  with  the  "more"  command. 
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NAME 

SETUPHON  •  6«ntrates  menu  tncssaqes. 

SYNOPSIS 

SETUPMON  0 

DESCRIPTION  ^  .u  *  *  4  1 

SETUPMON,  ganerates  all  the  menus  necessary  for  the  tutorial. 


NAME 


LEARN!  -  Learns  function  keys  to  mean  something  other  than  original 
meanings. 


SYNOPSIS 

LEARNl  0 

DESCRIPTION  , 

LEARNl,  defines  function  keys  to  mean  specific  things  other  than  thel 

original  meanings. 


NAME 

MESS  -  Controls  monitor  message  display. 

SYNOPSIS 

MESS  (1) 

1  -  Indicateawhich  message  to  display  In  menu  area. 

DESCRIPTION  ^  , 

MESS,  scrolls  the  monitor  to  the  proper  menu  for  display. 
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NAME 

MAIN  •  Generates  the  first  page  of  the  database  access  portion  of 
TACSYM. 

SYNOPSIS 
MAIN  0 

DESCRIPTION 

MAIN,  generates  the  first  page  of  the  database  access  portion  of 
TACSYM.  Definitions  of  the  access  methods  available  are  provided.  The 
routine  COMM  Is  executed  to  control  the  menu  driven  database  options. 
Upon  return  the  tutorial  portion  of  TACSYM  Is  called. 


NAME 

COMM  •  Command  menu  which  provides  access  and  manipulation  of  the 
database. 

SYNOPSIS 

COMM  (fig) 

fig  -  Flag  l.idicatea  whether  to  erase  the  work  area  of  the 
monitor  or  not. 

fig  -  1  then  erase;  fig  -  0  do  not  erase. 

I 

DESCRIPTION 

COMM,  generates  the  first  menu  which  provides  the  user  with  access  and 
manipulation  database  options.  Upon  user  selection  the  main  routine 
for  the  option  selected  Is  called.  The  options  available  are  scan, 
Insert,  delete,  find,  and  autoprlnt. 


NAME 

INSERT  -  Insert  menu  Is  generated  to  provide  Insertion  options. 

SYNOPSIS 

INSERT  0 

DESCRIPTION 

INSERT,  generates  the  Insert  menu  which  provides  the  options  of 
Inserting  symbols,  concepts,  sources  categories  and  primitives. 
The  appropriate  routine  Is  called  upon  user  selection. 
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NAME 

DELETE  •  0«1«t«  in«nu  is  generated  to  provide  deletion  options. 

SYNOPSIS 

DELETE  0 

DESCRIPTION 

DELETE  generates  the  delete  menu  which  provides  the  option  of  deleting 
symbols,  concepts,  sources,  categories  and  primitives.  The  appropriate 
routine  is  called  upon  user  selection. 


NAME 

INSERT  SYMBOL  -  Control  routine  for  Inserting  a  symbol  into  the 
database. 

SYNOPSIS 

INSERT  SYMBOL  () 

DESCRIPTION 

INSERT  SYMBOL,  generates  the  appropriate  symbol  header  If  needed.  It 
asks  for  the  number  of  the  symbol  to  be  entered.  It  takes  the  entered 
number  and  creates  a  file  name  for  it,  checks  If  It  already  exists  and 
If  so  asks  the  user  if  they  wish  to  recreate  It.  If  it  Is  recreated 
then  DELSYM  Is  executed.  If  the  symbol  is  being  recreated  or  being 
entered  for  the  first  time,  then  the  graphic  and  text  file  for  it  are 
created  and  opened.  The  symbol  number  is  appended  to  the  end  of  the 
symbol  control  file.  The  graphics  window  is  drawn  and  the  procedures 
which  enter  In  the  text  information  are  called.  The  PLAY  function  Is 
executed,  then  the  remarks  aj\d  flag  Information  is  asked  for.  Finally, 
the  graphic  and  text  files  are  closed. 
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NAME 

INSERT  PRIMITIVES  -  Control  routine  for  Inserting  a  primitive  into  the 

database. 


SYNOPSIS 

INSERT  PRIMITIVE  () 

DESCRIPTION 

INSERT  PRIMITIVE,  g'inerates  the  appropriate  primitive  header  if  needed. 
It  asks  for  the  name  of  the  primitive  to  be  entered.  It  creates  a  file 
name  from  the  entered  name.  Checks  if  the  file  already  exists  and  if 
so  asks  the  user  if  they  wish  to  recreate  it.  If  the  primitive  is  be¬ 
ing  recreated  or  being  entered  for  the  first  time  then  the  graphic  file 
Is  created  for  it.  If  it's  being  created  for  the  first  time,  its  name 
is  appended  to  the  end  of  the  primitive  control  file.  The  graphics 
window  is  then  drawn  and  the  PLAY  function  is  executed  to  generate  the 
primitive.  Finally,  the  graphics  file  is  closed. 


NAME 

INOEL  -  Control  routine  for  Inserting  or  deleting  a  concept,  source 
or  category. 

SYNOPSIS 

INOEL  (a ,  b.  p,  m,  n) 

a  -  Flag  Indicating  insertion  or  deletion  mode. 

1  •  insert,  0  ■  delete 
b  -  Flag  Indicating  proper  header  to  use. 

1  •  source,  2  ■  category,  3  ■  concept 
p  •  Name  of  the  control  file  for  a  source,  category  or  concept, 
m  «  Name  of  the  directory  for  a  source,  category  or  concept, 
n  "  Name  "source,"  "category,"  or  "concept",  to  be  used  in 
menu ' 8 


DESCRIPTION 

INDEL,  generates  the  appropriate  menu  for  inserting  or  deleting  a 
concept,  source,  or  category.  It  executes  SCANLIST  which  returns  a 
number  corresponding  to  an  item  in  a  list  to  delete  o'"  a  name  of  an  Item 
to  insert  or  exit.  If  the  mode  is  deletion,  then  the  reply  is  verified 
to  be  sure  its  a  number.  If  the  mode  Is  insertion  a  filename  Is 
created  from  the  returned  reply.  If  the  file  already  exists  an  error 
message  is  displayed  else  the  concept,  source  or  category  is  inserted 
via  INSCATCONSOU.  If  the  mode  is  deletion  then  the  number  returned  Is 
used  as  an  Index  into  the  file  to  retrieve  the  name  it.  corresponds  to. 

A  filename  is  created  from  this  name.  If  the  file  doesn't  exist  then 
an  error  message  is  displayed.  If  the  filr  exists  and  Is  empty  then 
it  is  deleted  via  the  DEl.CATCONSOU  routine.  If  it's  not  empty  then  an 
error  message  Is  displayed. 
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NAME 


DELCATCONSOU  -  Deletes  category,  concept  or  source  from  the  database. 
SYNOPSIS 

DELCATCONSOU  (p,  reply,  x) 

p  -  Name  of  the  contol  file  for  a  category,  concept, 
or  source. 

reply  -  Name  of  the  file  in  the  control  file  to  be 
deleted. 

X  -  Index  of  the  name  in  the  file. 


DESCRIPTION 

DELCATCONSOU,  deletes  the  file  that  was  contained  in  the  category, 
concept  or  source  directory.  It  creates  a  temporary  file  so  it  can 
copy  to  it  all  the  fUe  names  from  the  control  file  except  the  one  to 
be  deleted.  The  control  file, is  recreated  and  the  temporary  file  is 
written  to  it. 


NAME 

OELSYM 


Asks  for  the  symbol  number  to  delete  and  create  a  file  name 
for  the  number  entered. 


SYNOPSIS 

OELSYM  0 

DESCRIPTION 


OELSYM,  gets  the  symbol  number  to  be  deleted  and  creates  .a  file  name 
for  it,  then  calls  OELSYMl. 


NAME 

DELSYMl  -  Deletes  a  symbol  and  all  cross  references  for  the  database. 

SYNOPSIS 

DELSYMl  (id) 

id  -  File  name  of  symbol  to  be  deleted. 

DESCRIPTION 

DELSYMl,  opens  the  text  file  for  the  symbol  to  be  deleted.  From  the 
symbol  text  file  it  gets  the  category,  concept,  source  and  flagged 
Information  about  the  symbol.  For  each  attribute  it  executes 
OELSYMCCSF  to  remove  its  cross  references.  It  then  removes  the  graphc 
and  text  file  for  the  symbol  and  finally  removes  the  symbol  number  from 
the  symbol  control  file, 
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OELSYMCCSF  -  Deletes  e  symbol  number  from  Its  corresponding  category 
concept  source  and  If  rel event  for  the  flagged  symbol 
file. 


SYNOPSIS 

OELSYMCCST  (p,  buf.  Id) 

p  -  Name  of  the  category,  concept  or  source  directory. 

For  a  flagged  symbol  Its  the  control  file  for  flagged 
symbols. 

buf  -  Name  of  file  In  a  ipeclflc  category.  For  a 
flagged  symbol  buf  Is  empty. 

Id  -  Symbol  number  to  delete. 


DESCRIPTION  ■  . 

OELSYMCCSF,  creates  file  name  for  the  category,  concept  or  source  and 
creates  a  temporary  file.  The  contents  of  the  entire  file  except  the 
symbol  number  to  be  deleted  is  copied  to  the  temporary  file.  The  file 
Is  recreated  and  the  temporary  file  Is  copied  back  to  It. 


SOULINE  -  Gets  sources  from  the  test  file  and  calls  OELSYMCCSF 

to  delete  the  symbol  number  contained  In  these  sources. 

SYNOPSIS 

SOULINE  (buf,  X,  j,  Id) 

buf  -  String  from  text  file  containing  I  or  more  sources. 
X  -  Length  of  the  buf  string. 

J  -  Index  of  buf  where  processing  starts. 

Id  -  Symbol  number. 


DESCRIPTION  ^  ^  .... 

SOULINE,  takes  one  source  name  at  a  time  from  but  and  executes 
to  delete  the  symbol  number  from  the  corresponding  source  file. 


OELSYMCCSF 
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DELPRIM  >  Deletes  primitives  from  the  database. 

SYNOPSIS 

DELPRIM  0 

DESCRIPTION 

DELPRIM I  generates  the  appropriate  primitive  header  and  executes 
scan! 1st  to  generate  all  the  primitive  names  the  user  has  to  select 
from.  Upon  selecting  a  primitive  by  Its  list  numberj  DELPRIM  creates 
a  temporary  file  and  copies  all  the  primitive  names  from  the  primitive 
control  file,  except  for  the  one  selected.  Into  the  temporary  file. 

The  temporary  file  Is  copied  back  to  the  control  file. 


FINDSYMP.OL  -  Generates  a  specific  symbol  In  the  graphic  window. 

SYNOPSIS 

FI NOSYMBOL  () 

DESCRIPTION 

FINOSYM0OL,  asks  for  the  symbol  number  to  be  generated.  It  converts 
the  number  to  a  file  name.  The  symbol  Is  generated  along  with  Its 
anpropriate  text  Information. 


FINOPRIMITIVE  -  Generates  a  specific  primitive  In  the  graphics  window. 
SYNOPSIS 

FINOPRIMITIVE  () 

DESCRIPTION 

FINOPRIMITIVE,  generates  a  list  of  primitive  names  for  the  user  to 
pick  from.  The  primitive  selected  Is  then  qer.or8\;ed  In  the  graphics 
w1  ndow. 
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NAME 

MENU  •  Displays  the  desired  options  a  user  has  in  accessing  and 
manipulating  the  database. 

SYNOPSIS 

MENU  (Choice) 

Choice  «  Corresponds  to  the  menu  needed  for  a  specific  operation. 
DESCRIPTION 

MENU,  generates  a  list  of  options  that  are  provided  with  a  given 
instruction. 


NAME 

MENUl  -  Displays  different  instructions  depending  on  current  mode 
of  operation. 


SYNOPSIS 

MENUl  (a,  p) 

a  •  Corresponds  to  the  menu  needed  for  a  specific  operation, 
p  -  Character  string  to  be  used  in  the  menu  generated. 


DESCRIPTION 

MENUl,  displays  a  menu  giving  specific  instruction  of  what's  expected 
and  available  from  the  keyboard. 


NAME 

HEADING  -  Generates  a  header  on  the  first  line  of  the  workspace. 

SYNOPSIS 

HEADING  (p) 

p  -  Corresponds  to  the  appropriate  heading  that  is  needed, 

DESCRIPTION 

HEADING,  generates  a  heading  in  the  first  line  of  the  work  space  that 
corresponds  to  the  indicator  it  receives  as  an  argument. 
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PLAY  -  Controls  all  procedures  that  perform  function  key  operations 
related  to  "PLAY." 

SYNOPSIS 

PLAY  description  of  graphic  file  being  created.  It  can 

be  used  for  either  symbols  o.  primitives. 

OESCRIPTION^^n^rois  the  execution  of  the  function  key  commands  and  calls  the 
appropriate  routines  to  perform  cursor  movement,  graphic  operations, 
and  other  special  functions. 


E6RID  -  Erases  the  grid  numbers  placed  outside  the  graphics  window, 


SYNOPSIS 


EGRID  0 

DESCRIPTION^^^^^^  the  grid  numbers  placed  around  the  graphics  window, 


NAnh 

REGCHAR  -  Controls  display  of  text  in  the  graphics  window. 

SYNOPSIS 

REGCHAR  (fildes,  XI,  Yl)  u  * 

flldes  -  File  descriptor  of  graphics  file  where  text  is 

stored. 

XI,  Yl  -  Cursor  position  to  display  character. 

DESCRIPTION 

REGCHAR,  displays  characters  from  the  keyboard  In  the  graphics 

The  display  is  stopped  when  e1ther«hyfunct1oii  key  is  pressed  or  .he 

text  is  at  the  right  most  position  in  the  graphic  window. 
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NAME 

EKASE-WKITE  -  Executes  WRITEPTS  for  all  defined  points. 

SYNOPSIS 

ERASE-VIRITE  (point,  pts,  chr,  fd) 

point  >  Number  of  defined  points, 
pts  -  Array  of  defined  points, 
chr  -  Character  identifier  reprsenting  a  graphic 
element. 

fd  -  File  descriptor  of  graphics  file. 

DESCRIPTION 

ERASE-Wrlte,  executes  the  WRITEPTS  routine  to  write  a  record  of 
information  to  the  graphic  file  for  a  primitive  or  symbol. 


NAME 

WRITEPTS  •  Converts  Integers  to  ascii  and  stores  them  In  the 
graphics  file. 

SYNOPSIS 

WRITEPTS  (fd,  a,  b) 

fd  -  File  descriptor  of  graphics  file 
a,b  >  Coordinates  of  a  point  to  be  written  to  the 
graphics  file. 

DESCRIPTION 

WRITEPTS,  writes  a  coordinate  point  (a,b)  to  the  graphics  file.  The 
points  are  separatea  by  blanks  in  the  file. 


NAME 

MAKEROOM  -  Scrolls  the  workspace  to  make  room  for  a  new  graphics 
window  at  the  top  of  the  workspace. 

SYNOPSIS 

MAKEROOM  () 

DESCRIPTION 

MAKEROOM,  creates  room  for  a  new  graphics  window  at  the  ton  of  the 
monitor  area. 
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NAME 

SYMNUMINSERT  -  Inserts  the  symbol  number  In  the  symbol  text  file. 
SYNOPSIS 

SYMNUMINSERT  (Ydt,  Sid) 

fdt  -  File  descriptor  for  text  file. 

Sid  -  Symbol  number. 

DESCRIPTION 

SYMNUMINSERT,  writes  the  sytflbol  number  In  the  s.ymbol  text  file.  A 
“N"  Is  placed  before  the  numbar  as  a  number  Indicator. 


NAME 

SYMCATINSERT  -  Gets  and  stores  the  category  name  for  a  symbol. 
SYNOPSIS 

SYMCATINSERT  (fdt,  Id) 

fdt  -  File  descriptor  for  text  file. 

Id  •  Symbol  number. 


DESCRIPTION 

SYMCATINSERT, 


gets  the  category  nam«  via  keyboard.  It  appends  a  “  "  to 


the  name  and  writes  the  name  to  the  graphic  text  file.  It's  preceded 
by  "K;"  which  1nd1c.»tes  category  name.  If  a  flic  for  the  category  name 
In  the  category  directory  doesn't  exist  then  one  Is  created  by 
executing  INSCATCONSOU.  The  file  Is  opened  and  the  symbol  number  1s 
appenoed  to  It. 
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NAME 

SYMCON INSERT  -  Gets  and  stores  primary  and  secondary  concepts  for  a 
symbol . 


SYNOPSIS 

SYMCONINSERT  (fdt,  d) 

fdt  -  File  descriptor  for  a  text  file. 
Id  -  Symbol  number. 


OESCRIPTTUN 

SYMCONINSERT,  get  the  primary  concept  via  keyboard.  It  appends  a  "  " 
to  the  name  and  writes  It  to  the  graphics  text  fUa.  Its  preceded  by  a 
"C"  which  indicates  concept  name.  If  a  file  for  the  concept  name  in 
the  concept  directory  doesn't  exist  then  one  is  created  by  executing 
INSCATCONSOU,  This  file  is  opened  and  the  symbol  number  is  appended  to 
It.  TACSYM  allows  the  users  two  more  lines  for  the  entry  of  secondary 
concents.  These  are  entered  Into  the  graphics  text  file. 


NAME 

SYMSORINSERT  •  Gets  and  stores  the  sources  of  the  symbols. 

SYNOPSIS 

SYMSORINSERT  (fdt.  Id) 

fdt  -  File  descriptor  for  text  file. 

Id  -  Symbol  number. 

DESCRIPTION 

SYMSORINSERT,  gat  the  source  via  keyboard.  Sources  are  prompted 
until  the  user  exits  the  source  Input  mode  or  the  space  provided  (2 
lines)  for  sources  Is  filled.  The  sources  are  written  to  the  text 
file.  The  first  line  of  sources  Is  preceded  by  "S;"  which  Indicates 
source  names.  If  a  file  for  the  source  name  In  the  source  directory 
does  not  exist  then  one  Is  created  by  executing  INSCATCONSOU.  This 
file  is  opened  and  the  symbol  number  Is  appended  to  it. 
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INSCATCONSOU  -  Creates  a  category,  concept  or  source  within  the 
database. 

SYNOPSIS 

INSCATCONSOU  (p,  buff) 

p  •  Control  file  name  for  category,  concept  or  source, 
buff  -  Name  of  category,  concept  or  source. 

DESCRIPTION 

INSCATCONSOU,  creates  a  file  within  the  proper  category,  concept  or 
source  directory.  The  file  name  corresponds  to  the  name  of  the 
category,  concept  or  source.  It  also  appends  the  file  name  to  the 
control  file. 


SYMREMINSERT  -  Gets  and  stores  remarks  and  flags  Information  for  a 
symbol , 

SYNOPSIS 

SYMREAMINSERT  (fdt,  Id) 

fdt  -  File  descriptor  for  text  file. 

Id  •  Symbol  number. 

DESCRIPTION 

SYMREMINSERT,  provides  the  users  with  two  lines  to  Insert  any  remarks 
about  the  symbol  they  just  created.  The  first  line  Is  preceded  by  a 
"R:"  In  the  text  file.  The  user  Is  then  asked  If  the  symbol  should  bn 
flagged.  If  yes  Is  answered  then  a  "Y"  Is  written  to  the  text  file. 


otherwise 


Is  written.  The  flag  Is  preceded  by  a  "F:"  to  indicate 


flag  Information.  If  the  syumbol  Is  flagged,  then  the  control  file  for 
flagged  symbols  1s  opened  and  the  symbol  number  Is  appended  to  It. 


LEARN  -  Learns  specific  keys  on  the  keyboard  to  be  equivalent  to  other 
meanings  rather  than  their  original. 

SYNOPSIS 

LEARN  0 

DESCRIPTION 

LEARN,  defines  keys  on  the  keyboard  to  equal  specific  meanings  that  are 
used  In  the  code. 
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NAME 

RELEARN  -  Learns  a11  TACSYM  function  keys  to  mean  the  same  thing. 

SYNOPSIS 

RELEARN  () 

DESCRIPTION 

RELEARN,  defines  all  the  TACSYM  keys  to  be  the  same. 


NAME 

DRAWBOX  -  Sets  the  graphics  window  and  executes  a  box.  (A  box  provides 
the  area  In  which  symbols  may  be  drawn.) 


SYNOPSIS 

DRAWBOX  (flag) 

flag  -  Flag  to  Indicate  whether  to  call  up  a  box. 
Flag  ■  -1  don't  draw  Flag  ■  1  then  draw. 


DESCRIPTION 

DRAWBOX,  defines  the  graphics  window  and  If  flag  Is  not  equal  -1 
executes  box  to  draw  a  box  around  the  graphics  window. 


NAME 

AOFIG  -  Adds  a  symbol  or  primitive  to  the  graphics  file. 

SYNOPSIS 

AOFIG  (flldes,  x,  y,  symflag) 

flldes  -  File  description  of  graphics  file. 
x,y  Current  cursor  location  In  graphics  window, 
symflag  -  Flag  Indicating  If  adding  a  symbol  or  primitive, 
symflag  ■  1  symbol  s.ymflag  ■  0  primitive 


DESCRIPTION 

AOFIG,  gets  the  symbol  number  or  primitive  name  that  the  user  wishes  to 
Include  In  the  graphics  window.  A  symbol  or  primitive  identifier  (S  or 
P)  Is  written  in  the  graphics  file.  The  symbol  or  primitive  file  name 
follows.  The  (x,y)  relative  position  Is  put  after  the  file  name. 
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NAME 

REDO  -  Dilates  the  last  component  that  the  user  Inserted  In  the 
graphic  file. 


SYNOPSIS 

REDO  (flldes) 

flldes  -  File  descriptor  of  graphic  files. 


DESCRIPTION 

REDO,  takes  the  current  graphics  file,  whether  It  be  a  symbol  or  a 
primitive  and  eliminates  the  last  graphical  component  added  to  It. 
It  erases  the  graphics  window  and  redraws  the  graphics  In  It  except 
the  last  Item  added. 


NAME 

REDRAW  •  Redraws  the  graphics  window  contents. 

SYNOPSIS 

REDRAW  (flldes) 

flldes  -  File  descriptor  of  graphics  file. 


DESCRIPTION 

REDRAW,  erases  the  entire  graphics  window  and  redraws  Its  contents. 


NAME 

TEXTGEN  >  Generates  the  text  that  corresponds  to  a  graphic  symbol. 
SYNOPSIS 

TEXTGEN  (Id,  line) 

Id  -  Symbol  number. 

line  •  Line  on  screen  to  start  positioning. 


DESCRIPTION 

TEXTGEN,  opens  the  text  file  that  cooresponds  to  a  graphic  symbol. 
It  dumps  the  text  informtion  to  specified  areas  on  the  screen. 
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LOADBUF  -  Loads  a  buffer  with  text  until  a  new  line  character  1$ 
encountered. 

SYNOPSIS 

LOADBUF  (c,  buf,  fd) 

c  -  Character  which  starts  buffer, 
buf  -  Buffer  to  load  Information#, 
fd  -  File  descriptor  of  text  file. 

DESCRIPTION 

LOADBUF,  dumps  text  from  the  graphics  symbol  text  file  Into  a  buffer. 
A  newline  delimits  the  buffer. 


INSERZEROS  *  Prepends  zeros  to  the  three  numbers  that  comprise  a 
symbol  number. 

SYNOPSIS 

INSERZEROS  () 

DESCRIPTION 

INSERZEROS  prepends  zeros  to  three  numbers  that  comprise  a  s^wbol 
number.  The  zeros  are  added  If  the  numbers  digits  do  not  equal 
their  maximum  size  (I.e.  for  category  1  the  number  will  be  ni). 


WCNT  -  Breaks  up  keyboard  Input  using  special  characters  as  dollmlters. 

SYNOPSIS 

WCNT  (buff) 

buff  -  Keyboard  Input  buffer. 

DESCRIPTION 

WCNT,  scans  the  buffer  for  special  characters.  Once  a  special 
character  Is  encountered  a  new  word  Is  created  from  all  the  characters 
upto  this  special  character.  A  maximum  of  tJiree  words  Is  allowed  to  be 
created,  it  returns  the  number  of  words  created. 


DAT ABASE. C 


NAME 

CREATFILNAME  -  Creates  a  file  name  from  previously  broken  down  names. 
SYNOPSIS 

CREATFILNAME  (buff,  n) 

buff  -  Name  to  create, 
n  ■  Number  of  words  in  the  buffer. 


DESCRIPTION 

CREATFILNAME,  creates  a  file  name  from  the  number  of  words  broken  up 
from  the  Input  name.  The  file  name  could  look  like  the  following: 
for  1  word  6  characters,  a  period  and  three  characters  or, 

6  or  less  characters  and  a  period, 
for  Z  words  6  or  less  characters,  a  period  and  three  or  less 
characters. 

for  3  words  6  or  less  characters  (made  by  words  1  and  2) 
a  period  and  3  or  less  characters. 


P. 

f.: 

p. 
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NAHE 

SCAN  -  Controls  all  database  scanning  mechanisms. 

SYNOPSIS 
SCAN  0 

DESCRIPTION 

SCAN,,  controls  all  database  scanning*  Initially  It  generates  a 
definition  of  Its  menu  contents.  Upon  the  users  selection  it  calls  the 
appropriate  procedures  to  access  the  database.  SCAN  matches  the  users 
reply  with  the  proper  procedure  and  arguments  to  carry  out  the 
commands. 


NAME 

SCANLIST  -  Generates  page(s)  of.  sources,  concepts,  categories  and 
primitive  names. 

SYNOPSIS 

SCANLIST  (p,  reply,  replyl) 

p  -  Control  filename  corresponding  to  the  appropriate 
database  attribute. 

reply  -  Integer  value  cooresoonding  to  proper  heading  In 
''listheading''  routine, 
replyl  -  Users  returned  reply. 

I 

DESCRIPTION 

SCANLIST,  generates  an  enumerated  list  of  sources,  concepts,  categories 
or  primitives.  These  lists  are  used  tn  help  the  user  In  selection  and 
verification.  A  paging  mechanism  Is  also  used  in  the  event  cf  large 
lists. 
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SCANLATER  -  Scans  th«  database  by  the  appropriate  selection  made  In 
scanning  a  source,  concept  or  category  list. 

SYNOPSIS 

SCANLATER  (p,  reply,  pE) 

p  -  File  which  contains  the  name  of  the  specific  source, 
concept  or  category  to  scan  by. 
reply  •  Integer  character  corresponding  to  the  entry  In  the 
file  where  namee  Is  located. 

p2  -  Directory  name  where  the  specific  file  selected  from 
the  list  Is  located. 


DESCRIPTION 

SCANLATER,  converts  the  Integer  ASCII  character  "reply"  to  Integer  and 
uses  It  as  an  Index  to  gat  the  record  In  the  file  that  was  previously 
selected.  This  record  name  Is  converted  to  a  filename  and  appended  to 
1t$  directory.  The  entire  pathname  Is  snnt  to  SCANSYMS. 


NAME 

SCANPRIMS  -  Generates  consecutive  pages  of 
In  the  database. 


primitives  contained.  In 


SYNOPSIS 

SCANPRIMS  (p) 

p  -  Name  of  control  flip  which  contains  primitive  names. 

DESCRIPTION 

SCANPRIMS,  opens  the  primitive  control  file  which  contains  the  names  of 
all  the  primitives.  It  converts  these  .nemps  Into  file  names  and  opens 
the  files.  It  generates  five  primitives  per  page  and  displays  a 
message  asking  the  users  If  they  wish  for  another  page  or  want  to 
exit. 
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NAME 

SCANSYMS  -  Generates  consecutive  pages  of  symbols  contained  In  the 
database. 


SYNOPSIS 

SCANSYMS  (p) 

P  - 


Name  of  control  file  which  contains  symbol  names. 


DESCRIPTION 

SCANSYMS,  opens  the  symbol  control  file  which  contains  the  numbers  of 
all  the  symbols.  These  numbers  are  converted  to  symbol  graphic  and 
text  file  names  and  are  generated  on  the  screen.  SCANSYM  generates 
symbols  for  scanning  and  for  AUTOPRINT.  Scanning  generaters  5  symbols 
per  page  while  autoprint  generates  9. 


NAME 

LISTHEAOINQ  >  Generates  the  proper  heading  for  scanning  routines. 
SYNOPSIS 

LISTHEAOING  (type,  n) 

type  -  Cotresponds  to  which  heading  Is  desired, 
n  •  Used  to  calculate  columns. 


DESCRIPTION 

LISTHEAOING,  Generates  proper  heading  for  scan  routine. 


NAME 

PRINTSYMS  -  Gets  page  capacity  and  calls  SCANSYMS. 

SYNOPSIS  ■ 

PRINTSYMS  0 

DESCRIPTION 

PRINTSYMS,  used  to  call  SCANSYMS  for  AUTOPRINT  option. 
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SYNOPSIS 

SCANMENU  (1) 

1  -  Menu  to  generate 


DESCRIPTION 

SCANMENU.  generates  the  scan  menu. 
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NAME 

ARC  -  Generates  an  ARC  In  the  graphics  window. 

SYNOPSIS 

ARC  (point,  pts,  nflll) 

point  -  Interger  number  of  defined  points, 
pts  -  Interger  array  of  defined  points, 
nflll  -  Interger  flag  Indicating  whether  the  ere  la  to  be 
filled  or  not. 

1  -  Fin  0  ■  Don't  fin 


DESCRIPTION 

ARC,  processes  three  points  and  generates  an  arc  1n  the  graphics  window 
The  first  and  third  points  define  the  edges  of  the  arc  and  the  second 
point  defines  the  distance  from  the  arc's  base  (defined  as  a  line  con¬ 
necting  points  one  and  three)  to  Its  peak.  NFILL  Is  a  flag  used  to  de¬ 
termine  If  the  arc  should  be  filled  or  not. 


ARC2.C 


NAME 

COMPARC  -  Computes  points  on  the  arc. 

SYNOPSIS 

COMPARC  (tar) 

tar  -  Integer  array  of  points  used  to  calculate  new 
points  on  the  arc. 


DESCRIPTION 

COMPARC,  Is  called  by  the  arc  routine.  It  computes  the  points  that  He 
on  the  arc.  It  ’5  '•»iied  repeatedly  from  arc  until  all  necessary 
points  to  generate  the  appropriate  arc  are  computed. 
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NAME 


BOX  -  Generates  a  perimeter  box  for  the  graphics  window. 


SYNOPSIS 
BOX  0 

DESCRIPTION 

BOX,  displays  a  box  around  the  perimeter  of  the  graphics  window. 


CALL-FUNC  -  Calls  a  specific  graphic  function. 

SYNOPSIS 

CALL-FUNC  (points,  n,  c) 

points  -  Array  of  defined  points, 
n  -  Number  of  defined  points, 
c  -  Character  which  Indicates  which  graphic 
routine  to  call. 


DESCRIPTION 

CALL-FUNC, 
pending  on 


calls  the  circle, 
the  "c"  argument. 


arc,  connectpt,  or  flllpoiy  function  de 


NAME 

CIRCLE  -  Generates  a  circle  in  the  graphics  window. 

SYNOPSIS 

CIRCLE  (point,  pts,  fill) 

point  -  Number  of  defined  points, 
pts  -  Array  of  oeflned  points. 

fin  -  Flag  Indicating  whether  to  fill  circle  or  not. 
Fill  ■  1  fill  circle  Fill  -  0  don't  fill  circle 


DESCRIPTION 

CIRCLE,  generates  a  circle  in  the  graphics  window, 
points  to  define  the  circle's  diameter, 
then  the  circle  Is  filled. 


If  the 


It  requires  two 
"fin"  flag  ■  1 
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CLIP  -  Clips  vectors  that  pass  through  the  graphics  window's  edge. 
SYNOPSIS 

CLI“  (XI,  Yl,  X2|  Y2) 

Xl!  Yl'-  Coordinates  of  first  point  which  defines  a  vector. 

X2,  Y2  -  Coordinates  of  second  point  which  defines  a  vector. 

DESCRIPTION  '  ^ 

CLIP,  checks  If  a  vector  defined  by  two  points  passes  through  the 
graphics  window.  If  It  does,  new  points  are  calculated  to  egual  the 
points  where  It  passes  through  the  window.  A  i  is  returned  If  the 
resulting  points  lie  In  the  window. 


CODE  -  Assign  binary  value  used  In  CLIP  routine  depending  or  tj 
.  location. 

SYNOPSIS 

COOC  (x,y) 

x,y  -  One  point  defining  a  vector. 

DESCRIPTION 

CODE,  assigns  a  binary  value  which  Is  used  In  CLIP.  The  valiie  is 
assigned  according  to  the  x  and  y  locations. 


NAME 

CONNECTPTS  -  Connects  defined  points. 

SYNOPSIS 

CONNECTPTS  (point,  pts,  fiflag) 

point  -  number  of  defined  points, 
pts  -  Array  of  defined  points. 

fiflag  -  flag  Indicating  whether  to  connect  the  first 
and  last  point  defined, 
fiflag  ■  1  connect  first  and  last  point 
fiflag  ■  0  don't  connect  first  and  Ust  point. 


DESCRIPTION  ^  . 

CONNECTPTS,  generates  vectors  connecting  2  or  more  defined 
These  points  are  connected  1n  the  order  of  definition.  Iv  the  fiflag 
1  then  the  first  and  last  point  defined  Is  connected  by  a  vector. 
These  points  are  not  connected  if  fiflag  "  0. 
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NAME 

CURSOR  "  Executes  movement  of  the  cursor  1n  the  graphics  window. 

SYNOPSIS 

CURSOR  (xeh,  ych,  x,y) 

xch  -  Desired  change  in  x  movement, 
ych  -  Desired  change  in  y  movement. 
x,y  -  Current  location  of  cursor. 

DESCRIPTION 

CURSOR^  erases  the  current  cursor  in  the  graphics  window  and  checks  if 
the  desired  new  cursor  position  falls  in  the  graphics  window.  If  the 
new  cursor  will  not  fall  in  the  window  then  the  cursor  Is  redrawn  at 
Its  old  position  and  a  0  is  returned.  If  it  does  fall  in  the  window 
then  the  cursor  is  drawn  at  it's  new  position  and  a  1  is  returned. 


NAME 

DCROSS  -  Displays  representation  for  a  defined  point. 

SYNOPSIS 

DCROSS  (x.y) 

x,y  -  Point  to  generate  defined  point  representation. 

DESCRIPTION 

DCROSS,  generates  an  'X'  at  the  x,y  location  of  a  defined  point. 


NAME 

DPLUS  “  Generates  cursor  representation. 

SYNOPSIS 

DPLUS  (x.y) 

x.y  -  Point  to  generate  cursor  representation. 

0ESCRIP1I0N 

DPLUS,  generates  a  't'  at  the  x,y  location  of  the  current  beam 
position. 
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NAME 

■  DUMP  -  Generates  a  primitive  or  symbol  relative  to  the  current  cursor 
position. 

SYNOPSIS 

DUMP  (flldes,  x.y) 

flldes  -  File  descriptor  of  symbol  or  primitive. 
x,y  -  Coordinates  to  offset  the  primitive  or  symbol. 

DESCRIPTION 

DUMP,  gener  ates  a  primitive  or  symobl  relative  to  the  x,y  offset  It 
receives  as  an  argument.  It  can  be  called  recursively  to  generate 
embedded  symbols  and  primitives. 


NAME 

ERASEPTS  -  Erases  all  defined  points  from  the  graphics  window. 
SYNOPSIS 

ERASEPTS  (point,  pts) 

.  point  -  Number  of  defined  points, 
pts  -  Array  of  defined  points. 

DESCRIPTION 

ERASEPTS,  erases  all  defined  points  (represented  by  'X')  from  the 
graphics  window. 


NAME 

FILPOLY  -  Fills  a  simple  structured  polygon  with  3  to  4  sides. 

SYNOPSIS 

FILPOLY  (pts,  point) 

pts  -  Array  of  defined  points, 
point  -  Number  of  defined  points. 

DESCRIPTION 

FILPOLY,  generates  a  filled  polygon.  The  polygon  can  have  3  or  4  sides, 
where  the  top  and  bottom  must  be  parallel.  In  the  case  of  the  triangle 
(3  sides)  one  side  must  be  perfectly  horizontal. 
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NAME 

GENERATE  -  Sends  DUMP  routine  the  relative  position  to  generate  a 
primitive  or  symbol. 

SYNOPSIS 

GENERATE  (Id,  x,y) 

Id  -  Name  of  file  to  generate. 

x,y  -  Relative  location  to  position  files  contents. 

DESCRIPTION 

GENERATE,  opens  the  file  that  id^o  be  generated.  It  sends  the  file  des> 
criptor  and  the  x,y  relative  location  to  put  the  file,  to  DUMP. 


NAME 

GRID  -  Overlays  a  grid  on  the  graphics  window. 

SYNOPSIS 
GRID  C) 

DESCRIPTION 

GRID,  generates  a  grid  on  the  graphics  window.  This  Is  used  to  help 

bing  graph 


In  cursor  positioning  In  creating  graphics. 


NAME 

REDOPTS  -  Redraws  defined  points. 

SYNOPSIS 

REDOPTS  (point,  pts) 

point  -  Number  of  defined  points, 
pts  -  Array  of  defined  points. 

DESCRIPTION 

REDOPTS,  redraws  an  'X'  over  all  the  defined  points  in  the  graphics 
window. 


1(1 
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NAME 

RAW  -  Sets  Tektronix  terminal  not  to  echo  text  onto  the  monitor. 

SYNOPSIS 
RAW  0 

DESCRIPTION 

RAW,  sets  the  Tektronix  terminal  so  no  text  Is  echoed  on  the  monitor 
from  the  keyboard  or  the  host. 


NAME 

COOK  -  Sets  the  Tektronix  terminal  to  echo  text  onto  the  monitor. 

SYNOPSIS 
COOK  0 

DESCRIPTION 

COOK,  sets  the  Tektronix  terminal  to  echo  text  on  the  monitor  sent  from 
the  keyboard  or  the  host. 


STR.C 


NAME 

CATS  -  Concatinatt  two  strings  Into  a  resulting  string. 
SYNOPSIS 

CATS  (strl,  strZ,  result) 

strl,  str2  -  Two  strings  that  are  to  be  concatenated, 
result  >  String  that  two  strings  result  Is  stored. 

DESCRIPTION 

CATS,  concatenates  two  strings  Into  "result." 


NAME 

CITOA  -  Converts  Integer  to  character  string. 

SYNOPSIS 

CITOA  (1) 

1  >  Integer  to  convert  to  character  string. 

DESCRIPTION 

CITOA,  converts  an  Integer  to  a  character  string  by  executing  ITOS. 


NAME 

COMPS  -  Two  strings  are  compared  for  equality. 

SYNOPSIS 

COMPS  (strl,  StrZ) 

strl, StrZ  -  Two  strings  to  be  compared. 

DESCRIPTION 

COMPS,  compares  two  strings  and  returns  1  If  they  are  Identical, 
otherwise  It  returns  0. 
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NAME 

COPYS  -  Creates  a  copy  of  a  string. 

SYNOPSIS 

COPYS  (from,  to) 

from  -  String  being  copied, 
to  -  New  string. 

DESCRIPTION 

COPYS,  assigns  each  character  of  the  string  “from"  to  the  string  “to." 


NAME 

FINDI  •  Sequential  search  for  an  Integer  In  an  array  of  Integers. 
SYNOPSIS 

FINOI  (array,  length,  Integer) 
array  -  Array  of  integer. 

length  >  Number  of  Integers  In  the  array  to  sequentally 
search. 

Integer  -  Integer  to  find  In  the  array. 

DESCRIPTION 

FINDI,  sequentally  searches  an  array  of  Integers  for  a  specific 
Integer  and  returns  the  Indice  of  the  array  where  the  number  was  found. 
Otherwise  It  returns  -1. 


NAME 

F'.USHL  -  Flushes  all  characters  for  the  terminal's  buffer. 

SYNOPSIS 

FLUSH  0 

DESCRIPTION 

FLUSHL,  flushes  all  characters  from-the  terminal's  buffer,  until  a 
carriage  return  Is  encountered. 


STR.C 


NAME 

FLUSHLP  -  Flushes  all  the  characters  from  the  terminal's  buffer;  It 
checks  for  1  character  terminal  Input. 

SYNOPSIS 

FLUSHLP  0 

DESCRIPTION 

FLUSHLP,  flushes  all  characters  from  the  terminal's  buffer  until  a 
carriage  return  Is  encountered.  It  returns  a  0  If  one  character 
and  a  corriage  return  was  entered,  otherwise  a  1  Is  returned. 


NAME 

GETCH  -  Reads  a  character  from  a  file. 

SYNOPSIS 

GETCH  (flldes) 

flldes  -  File  descriptor. 


DESCRIPTION 

GETCH,  reads  one  character  from  an  Input  file  and  returns  that  character. 


NAME 

GETCOOR  -  Reads  a  pair  of  coordinates  needed  to  generate  a  symbol  or 
primitive. 


SYNOPSIS 

GETCOOR  (file,  x,y,  debug) 

file  -  File  to  get  coorinator  from. 
x,y,  -  Variable  to  return  coordinate  1n. 
debug  -  File  descriptor  for  debugging  an  error  In  the 
database  I.e.  f11e  doesn't  exist. 

DESCRIPTION 

GETCOOR,  opens  a  file  and  gets  the  first  x,y  coordinate  pair  of  the 
first  record  In  the  file.  If  the  file  1s  not  found  then  an  error 
message  1s  written  to  the  debug  file. 
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NAME 

GETNUM  •  Gets  an  ascii  character  number  and  returns  It  as  an  Integer. 

SYNOPSIS 

GETNUM  (fd) 

fd  -  File  descriptor  of  file  to  get  number  from. 

DESCRIPTION 

GETNUM,  reads  a  file  untl^  It  encounters  an  ascii  character  number 
and  converts  It  to  Integer.  GETNUM  returns  the  Integor.  ■ 


NAME 

GETRECORO  -  Gats  a  record  of  data  from  a  previously  loaded  buffer. 
SYNOPSIS 

GETRECORO  (fd,  buf,  rac.  n) 

fd  -  File  descriptor  of  I'lle  of  data. 

buf  -  Buffered  area  to  store  block  reads. 

rec  -  Record  area  to  store  a  record  read  from  buf. 

Record  defined  as  data  terminated  by  a  newline, 
n  -  Maximum  number  of  bytes  to  read  Into  buffer. 

DESCRIPTION 

GETRECORO,  copies  contiglous  bytes  from  the  buffer  to  the  record  until 
a  newline  Is  encountered.  Once  the  entire  buffer  Is  empty  and  EOF  has 
not  been  reached  then  the  buffer  Is  filled  again  with  bytes  from  the 
file.  A  1  Is  returned  on  a  successful  copy  to  the  record  and  a  0  Is 
returned  upon  EOF  or  read  error. 


NAME 

GETS  -  Gets  a  string  from  a  file. 

SYNOPSIS 

GETS  (flldes,  str) 

flldes  -  File  descriptor. 

str  -  Store  that  Is  gotten  from  file. 

DESCRIPTION 

GETS,  reads  a  character  string  from  a  file  and  assigns  It  to  STR. 
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NAME 

QETFLS  -  Gats  a  fixed  length  string  from  a  file. 

SYNOPSIS 

QETFLS  (flldes,  str,  cnt) 

flldes  -  File  descriptor  of  file. 

str  -  String  to  get. 

cnt  -  Maximum  length  string  can  be. 

DESCRIPTION 

QETFLS,  gets  a  string  from  a  file  which  can  be  no  longer  than  "cnt." 


NAME 

GET_STR  -  Gets  a  string  constrained  by  a  delimiter. 

SYNOPSIS 

GET  STR  (fd,  s,  d) 

fd  -  File  descriptor, 
s  -  String  to  get. 

d  -  Delimiter  to  Indicate  end  of  string. 

DESCRIPTION 

GET_STR,  gets  a  string  from  a  file.  The  string  Is  read  until  a  newline 
character  or  the  delimiter  Is  encountered. 


NAME 

ITOS  -  Converts  Integer  to  a  string, 

SYNOPSIS 

ITOS  (str,  1)  ■ 

str  -  String  that i*  created  from  Integer. 
1  -  Integer  to  convert  to  string. 


DESCRIPTION 

ITOS,  converts  an  Integer  number  to  a  character  string.  It  returns  the 
string  and  Its  length. 


NAME 


LENS  -  Calculates  the  length  of  a  string. 

SYNOPSIS 

LENS  (str) 

str  -  String  Itself. 

DESCRIPTION 

LENSt  computes  the  length  of  a  character  string  and  returns  that  length. 


NAME 

MATCH  -  Searches  a  character  string  for  a  character. 

SYNOPSIS 

MATCH  (isthlschar,  inthlsstrlng) 

Isthlschar  -  Character  being  searched. 

Inthlsstrlng  •  String  being  searched. 

DESCRIPTION 

MATCH,  searches  a  character  string  for  a  specific  character  and  returns 
a  1  If  that  character  Is  found  and  a  0  otherwise. 


NAME 

PUTO  -  Takes  an  Integer,  converts  It  to  ascii  and  writes  It  to  a  file. 
SYNOPSIS 

PUTD  (fd.  Integer) 

fd  -  File  descriptor  of  file  to  put  converted  Integer. 

DESCRIPTION 

PUTO,  converts  an  Integer  to  an  ascii  character  string  and  writes  the 
string  to  a  file. 
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NAME 

PUTS  -  Writes  a  string  to  a  file. 
SYNOPSIS 

PUTS  (flldes,  str) 

flldes  -  File  descriptor, 
str  -  String  to  write  to  file. 


DESCRIPTION 

PUTS,  writes  a  rtring  to  a  file. 


NAME 

SEARCH  -  Searches  character  array  for  a  string. 

SYNOPSIS 

SEARCH  (array,  abytes,  string,  sbytes) 
array  -  Character  array, 
abytes  -  Number  of  bytes  In  array 

string  -  Character  string, 

sbytes  -  Number  of  bytes  In  string. 


OESC.1IPTION 

SEARCH,  searchs  a  character  array  for  a  character  string.  If  found  the 
Index  where  the  string  starts  In  the  array  Is  returned  else  a  -I  Is  re¬ 
turned. 
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NAME 

BEAM  >  Positions  the  beam  position  In  the  Tektronix  graphics  window  at 
some  point. 


SYNOPSIS 

BEAM  (x.y) 

x,y  -  Integer  values  of  coordinates  to  position  beam  at. 


DESCRIPTION 

Beam,  checks  If  the  coordinates  It  receives  falls  In  the  graphics 
window.  If  they  do  then  It  positions  the  beam  there  and  returns  I, 
otherwise  It  returns  0. 


NAME 

CLEAR  -  The  keyboard  and  function  keys  are  set  to  their  original 
meanings 


SYNOPSIS 

CLEAR  0 


DESCRIPTION 

CLEAR,  sets  all  keyboard  and  function  keys,  that  may  have  been  rede> 
fined  to  mean  something  else  back  to  their  original  meanings. 


NAME 

OLINE  <  Deletes  lines  from  the  screen. 

SYNOPSIS 

OLINE  (a) 

a  -  Integer  number  of  lines  to  be  deleted. 

DESCRIPTION 

OLINE,  deletes  lines  from  the  screen,  relative  to  the  cursor  position. 
The  number  of  lines  to  delete  1s  determined  by  Its  parameter. 
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NAME 

DOWN  -  Move  cursor  down  a  page. 

SYNOPSIS 

DOWN  (a) 

a  -  Integer  number  of  lines  to  move  cursor  down. 

DESCRIPTION 

DOWN,  scrolls  the  cursor  down  the  Tektronix' s  screen.  The  number  of 
lines  to  move  the  cursor  Is  determined  by  Its  parameter. 


NAME 

ENHANCE  -  The  enhanced  or  standard  attribute  Is  attached  to  the  current 
cursor  position. 


SYNOPSIS 

ENHANNCE  (ch) 

ch  -  Character  Indicating  If  standard  or  enhanced  visual 
attributes  should  be  dlapleyed. 


DESCRIPTION 

ENHANCE,  receives  a  single  character  “s"  or  "e"  which  visually  displays 
the  standard  attribute  or  the  enhanced  attribute  respectively. 


NAME 

ERASE  -  Complete  easure  of  the  defined  workspace,  monitor,  or  graphics 
area. 


SYNOPSIS 

ERASE  (Ch) 

ch  -  Character  indicating  what  area  of  the  monitor  to  erase. 


DESCRIPTION 

ERASE,  receives  a  character  w,  m,  or  g  which  erases  the  workspace, 
monitor,  or  graphics  area  respectively. 
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NAME 

GRAPHIC  -  Defines  the  graphics  area  of  the  monitor. 

SYNOPSIS 

GRAPHIC  (a.b.o.d) 

a,b,c,d  -  Integer  number  Indicating  the  first  row,  last  row, 
first  column,  and  last  column  of  graphics  window, 
respectively. 

DESCRIPTION 

GRAPHIC,  receives  the  rows  and  columns  to  be  set  as  the  graphics  window. 


NAME 

HCOPY  -  Generates  hard  copy  of  workspace,  monitor  or  the  entire  screen. 

SYNOPSIS 

HCOPY  (ch) 

ch  -  Character  indicating  what  area  of  the  screen  to  generate  the 
hard  copy. 


DESCRIPTION 

HCOPY,  receives  a  character  w,m,  or  s  indicating  v<hether  <to  print  a 
hardcopy  of  the  workspace,  monitor  area,  or  the  entire  screen,  re¬ 
spectively. 


NAME 

ILINE  -  Inserts  lines  on  monitor. 

SYNOPSIS 

ILINE  (a) 

a  -  Integer  number  of  how  many  lines  to  insert. 


5 
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DESCRIPTION 

ILINE,  receives  an  integer  indicating  how  many  lines  to  insert  into 
the  monitor.  It  inserts  that  many  lines. 
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NAME 

JUMP  -  Quick  relocation  of  cursor  In  the  workspace. 

SYNOPSIS 

JUMP  (x^y) 

x,y  >  Integer  line,  column  position  In  the  workspace. 

DESCRIPTION 

JUMP,  win  move  the  cursor  to  the  line,  column  position  In  the  workspace 
which  corresponds  to  Its  parameters. 


NAME 

LEFT  -  Moves  cursor  to  the  left. 

SYNOPSIS 

LEFT  (a) 

a  -  Integer  number  of  how  many  positions  to  move  the  cursor  to 
the  left. 


DESCRIPTION 

LEFT,  moves  the  cursor  from  Its  current  position  to  the  left.  The 
number  of  positions  It  Is  moved  Is  determined  by  Its  parameter. 


NAME 

LINE  -  Sets  the  type  of  line  to  draw  via  the  vector  command. 

SYNOPSIS 

LINE  (ch) 

ch  -  Character  which  determines  type  of  line  to  set. 


DESCRIPTION 

LINE,  sets  the  different  line  representation  available.  Lines  range 
from  dots  to  solid.  Blank  lines  are  also  available  for  erasing 
purposes. 
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NAME 

MONITOR  -  Sets  the  monitor  area  and  Its  Input  constraints. 

SYNOPSIS 

MONITOR  (str) 

str  -  String  which  can  Indicate  the  monitor  area,  or  what  can 
communicate  to  the  monitor  (the  host  or  keyboard). 


DESCRIPTION 

MONITOR,  receives  a  character  string  which  can  be  the  number  of  lines 
for  the  monitor,  or  the  character  h  which  directs  text  from  the  host  to 
the  monitor,  or  the  character  K  which  directs  text  from  the  keyboard  to 
the  monitor. 
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NAME 

RIGHT  -  Moves  cursor  to  the  right. 

SYNOPSIS 

RIGHT  (a) 

a  -  Integer  number  of  how  many  positions  to  move  the  cursor  to 
the  right. 


DESCRIPTION 

RIGHT,  moves  the  cursor  from  its  current  position  to  the  right.  The 
number  of  positions  it  is  moved  is  determined  by  Its  parameter. 


NAME 

TEKCHAR  -  Generates  character  in  the  graphics  window. 

SYNOPSIS 

TEKCHAR  (c) 

c  >  Character  to  be  displayed  In  the  graphics  window. 

DESCRIPTION 

TEKCHAR,  receives  a  character  which  Is  sent,  to  the  graphics  window 
and  displayed  at  the  current  beam  position. 
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NAME 


TEKSTR  -  Generates  string  In  graphics  window. 

SYNOPSIS 

TEKSTR  (str) 

str  -  String  to  be  displayed  In  the  graphics  window. 

DESCRIPTION 

TEKSTR,  receives  a  string  of  text  which  Is  displayed  In  the  graphics 
window  at  the  current  beam  position. 


NAME 

UP  -  Move  cursor  up. 

SYNOPSIS 
UP  (a) 

a  >  Integer  number  to  move  the  cursor  up  the  screen. 

DESCRIPTION 

UP,  moves  the  cursor  up  the  screen.  The  number  of  lines  It  moves  the 
cursor  Is  determined  by  Its  parameter. 


NAME 

VECTOR  -  Draws  line  between  two  points. 

SYNOPSIS 

VECTOR  (X1,Y1,X2,Y2) 

X1,Y1,X2,Y2  -  Integer  coordinates  which  represent  points  one 
and  two. 

DESCRIPTION 

VECTOR,  draws  a  line  between  two  points  It  receives.  The  type  of  line 
It  draws  Is  determined  by  the  line  command. 


WORKSPACE  -  Sets  the  workspace  area  and  its  Input  constraints. 

SYNOPSIS 

WORKSPACE  (str) 

str  -  String  which  indicates  the  workspace  area,  or  what 
can  communicate  to  the  workspace  (the  host  or  key¬ 
board). 

DESCRIPTION 

WORKSPACE,  receives  a  character  string  which  can  be  the  number  of  lines 
for  the  workspace,  or  the  character  h  which  directs  text  from  the  host 
to  the  workspace,  or  the  character  K  which  directs  text  from  the 
keyboard  to  the  workspace. 
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NAME 

ATAN  -  Computes  arc  tangent  of  a  slope. 

SYNOPSIS 

ATAN  (x) 

X  •  Double  precision  variable  of  the  slope  of  a  line. 

DESCRIPTION 

ATAN,  computes  the  Inverse  tangent  of  the  slope  X  and  returns  the 
answer  In  radian  measure. 


NAME 

SORT  -  Computes  square  root  of  1/Y. 

SYNOPSIS 

SORT  (y) 

y  >  Double  precision  variable. 

DESCRIPTION 

SQRT,  computes  the  square  root  of  1  divided  by  y.  This  routine  1s 
used  exclusively  for  ATAN.  Returns  the  answer  In  double  precision. 


NAME 

POW  -  Raises  some  number  to  some  power. 

SYNOPSIS 

POW  (y.n) 

y,n  -  Double  precision  variable. 

DESCRIPTION 

POW,  computes  y  raised  to  the  nth  power.  It  returns  the  answer  In 
double  precision. 


NAME 


SIN  -  Computes  the  sine  of  some  number. 

SYNOPSIS 
SIN  (a) 

a  -  Double  precision  variable 
DESCRIPTION 

SIN,  receives  an  angle  in  radian  measure  and  returns  the  sine  of  that 
angle.  The  sine  is  returned  in  double  precision  radian  measure. 


NAME 

COS  -  Computes  the  cosine  of  some  number. 

SYNOPSIS 
COS  (a) 

a  -  Double  precision  variable. 

DESCRIPTION 

COS,  receives  an  angle  in  radian  measure  and  returns  the  cosine  of  that 
angle.  The  cosine  is  returned  in  radian  measure. 


NAME 

FABS  -  Computes  the  absolute  value  of  double  precision  variable. 

SYNOPSIS 

FABS  (z) 

z  -  Double  precision  variable. 

DESCRIPTION 

FABS,  computes  the  floating  point  absolute  value  of  a  variable  and 
returns  it  as  double  precision. 


4.  DETAILED  OPERATIONAL  DESCRIPTION 


4.1  Initialization  of  System 

Assuming  the  user  Is  currently  logged  on  the  system  and  positioned  at  the 
proper  directory  which  contains  the  TACSYM  program,  type  TACSYM.  This  should 
generate  the  first  page  of  TACSYM  with  three  options  available  for  selection. 
By  typing  a  1 ,  the  tutorial  part  of  TACSYM  will  be  executed.  This  causes  the 
current  page  to  be  erased  and  a  wait  message  to  be  displayed  while  the  tu¬ 
torial  menus  are  being  generated.  By  typing  a  2,  the  catalogue  access  and 
the  modification  part  of  TACSYM  will  be  executed.  This  causes  the  current 
page  to  be  erased  and  the  first  menu  of  the  access  and  modification  section 
to  be  displayed.  By  typing  a  3,  the  program  Is  terminated  and  the  screen 
erased  with  the  system  prompt  sign  displayed.  If  the  EXIT  key  Is  pressed  at 
this  point  the  prompt  sign  will  show  1n  the  monitor  area,  Simply  typing 
TACSYM  again  followed  by  the  number  3  will  properly  clear  the  screen. 

4.2  Tutorial  Processor  Component 

Once  at  the  first  page  of  the  tutorial,  a  tree  diagram  Is  seen  with  an  Indi¬ 
cation  of  where  the  user  currently  Is  In  the  system.  The  enhanced  text  Is 
a  selection  mechanism  which  will  be  used  throughout  the  tutorial.  It  Is 
controlled  by  the  cursor  function  keys  (function  keys  2  and  3).  The  menu 
explains  the  options  the  user  has  at  the  current  level  of  the  system.  By 
pressing  function  keys  2  and  3  the  enhanced  text  will  alternate  until 
CONFIRM  or  EXIT  Is  pressed.  CON'FIRM  will  take  the  user  to  the  section  of 
the  tutorial  that  Is  highlighted  while  an  EXIT  will  take  the  user  up  one 
level  to  the  first  page.  CONFIRM  acts  as  a  selection  button,  taking  the 
user  one  more  level  into  the  tutorial.  Conversely,  EXIT  acts  as  a  backing 


out  button,  taking  the  user  one  more  level  out  of  the  tutorial  to  the  pre¬ 
vious  selection  menu.  The  tutorial  Is  broken  up  Into  two  parts.  Part  one 
Is  the  System  Operations  and  part  two  Is  the  Executive  Summary.  System  Op¬ 
erations  and  Executive  Summary  are  further  broken  down  Into  three  sections 
each. 

Systems  Operations 

Systems  operations  consists  of  how  to  use  the  keyboard,  catalogue  structure 
description  and  a  narrative  on  how  to  access  the  catalogue.  Mow  to  use  the 
keyboard  is  broken  down  Into  a  definition  and  Illustration  walk-through  of 
the  function  keys  which  are  positioned  at  the  top  of  the  keyboard  and  a  sym¬ 
bol  and  primitive  creation  practice  session.  The  definition  and  Illustration 
walk-through  reads  like  a  book,  In  that  you  can  page  forward  or  backward  one 
page  at  a  time,  exit  at  any  time,  or  repeat  a  page.  The  symbol  and  primitive 
creation  practice  session  provides  the  user  with  a  graphics  window  where  he 
can  experiment  with  the  function  keys.  Uoon  exiting  from  this  practice  ses¬ 
sion  the  tutorial  menus  will  be  generated  again.  The  catalogue  structure 
consists  of  a  brief  explanation  of  its  capabilities  and  characteristics. 

How  to  access  the  catalogue  1s  a  brief  paragraph  explaining  keyboard  opera¬ 
tions  of  how  to  enter  and  exit  levels  of  the  system. 

Executive  Summary 

The  Executive  Summary  consists  of  an  overview,  general  rules  and  sample  sym¬ 
bols.  The  overview  Is  broker,  down  Into  a  summary  of  the  symbology  program, 
results  of  the  symbology  survey,  symbol  discrimlnabll Ity  and  TACSYM  system 
development.  The  general  rules  consist  of  development  rules  for  specific 
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symbology  sources  for  the  UNIT,  WEAPON,  and  POST  and  INSTALLATION  symbols. 

It  also  explains  color  rules.  Sample  symbols  consist  of  a  range  of  symbols 
contained  in  the  database. 

^•3  Query  Processor  Component 

The  top  menu  of  the  symbology  catalogue  contains  six  options  for  the  user; 
one  is  to  scan  the  database,  two  Is  to  insert  something  into  the  database, 
three  is  to  delete  something  from  the  database,  four  is  to  find  something 
In  the  database,  five  Is  to  automatically  print  all  symbols  in  the  database 
and  six  is  to  exit  the  symbology  catalogue.  The  initial  title  and  definition 
on  the  first  menu  are  only  displayed  upon  first  entry  into  the  catalogue. 

Scan 

In  scanning  the  database  six  options  are  available;  one  is  scan  by  source, 
two  is  scan  by  category,  three  is  scan  by  concept,  four  is  scan  all  symbols, 
five  is  scan  all  flagged  symbols  and  six  is  scan  all  primitives.  In  scan¬ 
ning  by  the  first  three,  an  enumerated  list  of  potential  items  to  scan  by 
is  generated.  The  user  can  enter  in  the  appropriate  number  and  press  con¬ 
firm,  exit,  or  if  more  than  one  page  of  items  exists,  press  confirm  for  the 
next  page.  If  a  number  is  entered  tnen  the  symbols  corresponding  to  that 
numbered  item  are  displayed.  In  scanning  all  symbols,  flagged  symbols  or 
primitives,  TACSYM  generates  a  page  of  the  item  selected  and  waits  for  a 
confirm  to  generate  the  next  page,  or  an  exit  which  goes  back  to  the  scan 
menu.  The  explanation  of  the  scan  ..apabilities  at  the  top  scan  menu  is  only 
displayed  on  the  first  pass  into  the  scanning  options. 
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Insert/Del ete 

To  Insert  or  delete  to  and  from  the  database,  five  options  are  available; 
one  is  symbol,  two  is  concept,  three  is  source,  four  Is  category  and  five 
is  primitive.  To  insert  a  symbol,  the  number  the  user  wishes  to  associate 
the  symbol  with  is  asked  for  in  the  form  of  n.n.n.  If  a  symbol  already  ex¬ 
ists  with  that  number  then  the  user  is  asked  to  press  confirm  if  he  wants 
to  replace  it.  During  symbol  insertion  the  category  name  is  asked  for,  then 
the  primary  concept  and  then  the  secondary  concept.  Two  lines  are  allocated 
for  the  secondary  concept.  The  sources  are  requested  one  at  a  time  until 
the  user  indicates  by  pressing  exit  that  he  is  finished  entering  them  or  no 
room  exists  for  more.  The  symbol  1s  then  created  via  function  keys.  Two 
lines  are  then  allocated  for  remarks  and  finally  the  user  is  asked  if  he/she 
wishes  to  flag  the  symbol  or  not.  To  delete  a  symbol,  the  system  asks  for 
the  symbol  number  of  the  symbol  associated  with  it.  To  Insert  a  concept, 
source  or  category  the  system  generates  a  list  of  the  specified  item's  con¬ 
tents  and  asks  the  user  to  type  in  the  new  item  not  already  in  the  list.  To 
delete  a  concept,  source  or  category  the  system  generates  a  list  of  the 
specified  item's  contents  and  asks  the  user  to  enter  the  number  correspond¬ 
ing  to  the  item  he/she  wishes  to  delete.  If  this  item  is  used  anywhere  else 
in  the  database  (i.e.,  it's  a  concept  of  an  existing  symbol),  it  will  not  be 
removed.  To  Insert  a  primitive  the  name  is  asked  for.  If  the  name  of  the 
new  primitive  is  the  same  as  one  already  in  the  system  the  user  is  asked  to 
confirm  if  he/she  wishes  to  recreate  it.  During  primitive  insertion  the  func¬ 
tion  keys  are  then  used  in  creating  the  primitive.  To  delete  a  primitive 
the  list  of  primitives  is  generated  and  the  user  is  asked  to  enter  the  cor¬ 
responding  number  of  the  primtive  he/she  wishes  to  delete.  Note  an  already 


existing  primitive  or  symbol  may  be  used  by  another  primitive  or  symbol; 
be  sure  that  this  is  not  the  case  before  deleting  it. 

Find 

Find  Is  used  to  generate  a  specific  symbol  or  primitive.  To  find  a  symbol, 
enter  in  the  symbol  number  in  the  form  of  n.n.n;  this  will  display  the  sym- 
bol  for  that  symbol  number  on  the  monitor.  If  the  symbol  does  not  ex<st, 
then  an  error  message  will  appear.  In  finding  a  primitive,  a  list  of  primi¬ 
tive  names  is  generated  and  the  user  is  asked  to  enter  the  number  correspond¬ 
ing  to  the  primitives  he/she  wishes  to  disp1a\y-  This  primitive  is  then  dis¬ 
played  on  the  monitor. 


Autoprint 

Autoprint  requires  the  hard  copy  device  to  be  turned  on.  Autoprint  will  gen¬ 
erate  all  the  symbols  currently  in  the  database.  This  option  allows  the  user 
to  leave  th«  system  unattended  while  it  generates  and  copies  all  symbols. 


4.4  User  Interface 

The  monitor  has  the  capability  of  utilizing  two  areas  of  its  screen.  During 
the  execution  of  TACSYM  the  lower  portion  of  the  monitor  is  used  as  a  menu 
area  while  the  rest  of  the  monitor  is  used  for  information  display.  The 
menu  areas  Instruct  the  user  as  to  what  is  expected  from  the  keyboard. 


TACSYM  does  key  validation  of  any  number  or  name  entered  into  the  system. 
TACSYM  will  check  if  the  coinmand  is  correct  and  process  it  accordingly. 
Otherwise  TACSYM  will  ask  for  the  command  again  or  display  a  message 


indicating  what  was  wrong.  TACSYM  was  designed  with  the  user  in  mind.  A1 
lowing  the  system  to  guide  the  user  will  be  to  his/her  advantage. 


